---
title: "List Comments"
description: "Lists comments for particular document. Returns only comments which are not deleted."
---

> Documentation Index
> Fetch the complete documentation index at: /api-docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Comments

<div class="endpoint-signature"><span data-method="GET">GET</span><code>/api/v1_2/documents/:document_id/comments</code></div>

Lists comments for particular document. Returns only comments which are not deleted.

## Path parameters

| Name | Example | Description |
|---|---|---|
| `document_id` | — | — |

## Code examples

### cURL

```curl
curl --request GET 'https://app.datamolino.com/api/v1_2/documents/98765/comments' \
  --header 'Authorization: Bearer demo_access_token'
```
### HTTP

```http
GET /api/v1_2/documents/98765/comments HTTP/1.1
Host: app.datamolino.com
Authorization: Bearer demo_access_token
```
### JavaScript Fetch

```javascript
const response = await fetch("https://app.datamolino.com/api/v1_2/documents/98765/comments", {
  method: "GET",
  headers: {
"Authorization": "Bearer demo_access_token"
  },
});

const data = await response.json();
```
### Node.js Axios

```javascript
import axios from "axios";

const response = await axios({
  method: "get",
  url: "https://app.datamolino.com/api/v1_2/documents/98765/comments",
  headers: {
"Authorization": "Bearer demo_access_token"
  }
});

console.log(response.data);
```
### Python Requests

```python
import requests

url = "https://app.datamolino.com/api/v1_2/documents/98765/comments"
headers = {
  "Authorization": "Bearer demo_access_token"
}

response = requests.request("GET", url, headers=headers)
response.raise_for_status()
print(response.json())
```
### Ruby Net::HTTP

```ruby
require 'json'
require 'net/http'

uri = URI("https://app.datamolino.com/api/v1_2/documents/98765/comments")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer demo_access_token"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts JSON.parse(response.body)
```
### Ruby on Rails

```ruby
# app/services/datamolino_client.rb
require 'json'
require 'net/http'

class DatamolinoClient
  BASE_URL = "https://app.datamolino.com"

  def initialize(access_token: Rails.application.credentials.dig(:datamolino, :access_token))
@access_token = access_token
  end

  def request_list_comments
uri = URI("#{BASE_URL}/api/v1_2/documents/98765/comments")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer #{@access_token}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

JSON.parse(response.body)
  end
end
```
### PHP Guzzle

```php
<?php

use GuzzleHttp\Client;

$client = new Client();
$response = $client->request('GET', 'https://app.datamolino.com/api/v1_2/documents/98765/comments', [
'headers' => json_decode('{"Authorization":"Bearer demo_access_token"}', true)
]);

echo $response->getBody();
```
### Java OkHttp

```java
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
.url("https://app.datamolino.com/api/v1_2/documents/98765/comments")
.addHeader("Authorization", "Bearer demo_access_token")
.method("GET", null)
.build();

Response response = client.newCall(request).execute();
```
### C# HttpClient

```csharp
using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://app.datamolino.com/api/v1_2/documents/98765/comments");
request.Headers.Add("Authorization", "Bearer demo_access_token");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
```
### Go Native

```go
client := &http.Client{}
req, err := http.NewRequest("GET", "https://app.datamolino.com/api/v1_2/documents/98765/comments", nil)
if err != nil { panic(err) }
req.Header.Add("Authorization", "Bearer demo_access_token")

res, err := client.Do(req)
if err != nil { panic(err) }
defer res.Body.Close()

body, err := io.ReadAll(res.Body)
if err != nil { panic(err) }
fmt.Println(string(body))
```
### Swift URLSession

```swift
import Foundation

var request = URLRequest(url: URL(string: "https://app.datamolino.com/api/v1_2/documents/98765/comments")!)
request.httpMethod = "GET"
request.setValue("Bearer demo_access_token", forHTTPHeaderField: "Authorization")

let (data, _) = try await URLSession.shared.data(for: request)
print(String(data: data, encoding: .utf8)!)
```

## Responses

### 200 OK

Content type: `application/json`

```json
{
  "links": {
"self": {
  "href": "https://beta.datamolino.com/api/v1_2/documents/398442/comments?access_token=demo_access_token"
}
  },
  "comments": [
{
  "links": {
    "self": {
      "href": "https://beta.datamolino.com/api/v1_2/documents/398442/comments/demo_identifier"
    },
    "author": {
      "id": 9891,
      "href": "https://beta.datamolino.com/api/v1_2/users/9891",
      "name": "Demo Trading Ltd",
      "surname": "Novak",
      "type": "users"
    },
    "document": {
      "id": 398442,
      "href": "https://beta.datamolino.com/api/v1_2/documents/398442",
      "type": "documents"
    }
  },
  "text": "Another user comment",
  "author_id": 9891,
  "document_id": 398442,
  "state": "created",
  "uuid": "7f3a2d4e-9a1b-4c6d-8e0f-123456789abc",
  "created_at": "2022-11-18T08:20:39Z",
  "last_modified_at": "2022-11-23T13:17:50Z"
},
{
  "links": {
    "self": {
      "href": "https://beta.datamolino.com/api/v1_2/documents/398442/comments/demo_identifier"
    },
    "author": {
      "id": 10114,
      "href": "https://beta.datamolino.com/api/v1_2/users/10114",
      "name": "Demo Trading Ltd",
      "surname": "Novak",
      "type": "users"
    },
    "document": {
      "id": 398442,
      "href": "https://beta.datamolino.com/api/v1_2/documents/398442",
      "type": "documents"
    }
  },
  "text": "Example Comment",
  "author_id": 10114,
  "document_id": 398442,
  "state": "created",
  "uuid": "7f3a2d4e-9a1b-4c6d-8e0f-123456789abc",
  "created_at": "2022-11-16T08:57:27Z",
  "last_modified_at": "2022-11-23T13:15:11Z"
}
  ]
}
```

Source: /api-docs/reference/comment/list-comments/index.md