Explore documentation
  1. Welcome to Incidents 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Tag on-call in Slack
    4. Mobile apps ↗
    5. Connecting external calendars
    6. Advanced guide
  4. Incident management
    1. Get started
    2. Post mortems
    3. Metadata & Catalog
    4. Screening alerts
    5. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Incidents API
    1. Getting an API token
    2. Pagination
    3. Monitors
    4. Heartbeats
    5. On-call & incidents
      1. On-call schedule
      2. On-call schedule events
      3. On-call schedule rotations
      4. Escalation policies
      5. Escalation policy groups
      6. Severities
      7. Severity groups
      8. Incidents
      9. Comments
        1. List comments GET
        2. Get comment GET
        3. Create comment POST
        4. Update comment PATCH
        5. Remove comment DELETE
    6. Status pages
    7. Metadata
    8. Integrations
    9. Team members
    10. Organization roles
    11. Usage
    12. Reporting

List comments

List all comments under an incident. This endpoint does not support pagination and returns all comments instead.

GET https://incidents.betterstack.com/api/v2/incidents/{incident_id}/comments

URL parameters

incident_id
required string

The ID of the incident

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
string

application/json

200

Returns list of existing comments under incident

Response 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"
      }
    }
  ]
}
404

Incident was not found

Response attributes

id
string

The ID of the comment.

type
string

Always incident_comment.

attributes.id
integer

The ID of the comment, as a number.

attributes.content
string

The text of the comment.

attributes.user_id
integer

The ID of the user who posted the comment, left out when no user posted it, for example a comment added with an API token.

attributes.user_email
string

The e-mail address of the user who posted the comment, left out together with user_id.

attributes.created_at
string

When the comment was posted, in ISO 8601 format.

attributes.updated_at
string

When the comment was last changed, in ISO 8601 format.

Example cURL

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


Previous article

Remove incident

Next article

Get comment