# List comments

List all comments under an incident. This endpoint does not support [pagination](https://betterstack.com/docs/uptime/api/pagination/) and returns all comments instead.

[endpoint]
base_url = "https://uptime.betterstack.com"
path = "/api/v2/incidents/{incident_id}/comments"
method = "GET"

[[path_param]]
name = "incident_id"
description = "The ID of the incident"
required = true
type = "string"

[[header]]
name = "Authorization"
description = "Bearer `$TOKEN`"
required = true
type = "string"

[[header]]
name = "Content_Type"
description = "application/json"
required = false
type = "string"
[/endpoint]

[responses]
[[response]]
status = 200
description = '''Returns list of existing comments under incident'''
body = '''{
  "data": [
    {
      "id": "123",
      "type": "incident_comment",
      "attributes": {
        "id": 123,
        "content": "posted from API",
        "created_at": "2025-06-03T12:10:28.357Z",
        "updated_at": "2025-06-03T12:10:28.357Z"
      }
    },
    {
      "id": "124",
      "type": "incident_comment",
      "attributes": {
        "id": 124,
        "content": "posted by user",
        "user_id": 456,
        "user_email": "test@example.com",
        "created_at": "2025-06-03T12:10:28.450Z",
        "updated_at": "2025-06-03T12:10:28.450Z"
      }
    }
  ]
}'''

[[response]]
status = 404
description = '''Incident was not found'''
body = ''''''
[/responses]

#### Example cURL 

```shell
[label Example]
curl --url https://uptime.betterstack.com/api/v2/incidents/1/comments \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json'
```