Explore documentation
  1. Welcome to AI SRE 👋
  2. AI SRE vs MCP server
  3. Customize AI SRE
  4. Writing code
    1. Creating pull requests for errors
    2. Bulk resolving errors
  5. Analyzing data
    1. Analyzing incidents
    2. Analyzing logs
    3. Checking for outliers
  6. Managing data
    1. Creating dashboards
    2. Importing Datadog dashboards
    3. Importing Grafana dashboards
  7. Integrations
    1. Linear
    2. Sentry
    3. Datadog
    4. Grafana
    5. GitHub
    6. Notion
  8. AI SRE API
    1. Getting an API token
    2. Chats API
      1. List all chats GET
      2. Get a single chat GET
      3. Create a chat POST
      4. Get chat status GET
      5. Reply to a chat POST
      6. Approve or deny a confirmation PATCH
      7. Remove a chat DELETE
    3. List models GET

List all chats

Returns a paginated list of your team's chats.

GET https://chat.betterstack.com/api/v2/chats

Query parameters

team_name
string

Filter chats belonging to a specified team when using global API token.

page
integer

Page number

per_page
integer

Items per page (default: 50, max: 250)

Headers

Authorization
required string

Bearer $TOKEN

200

Returns a paginated list of chats, most recently updated first.

Response body

{
  "data": [
    {
      "id": "12345",
      "type": "chat",
      "attributes": {
        "team_id": 123456,
        "team_name": "example-team",
        "name": "Checkout 5xx spike",
        "status": "idle",
        "message_count": 4,
        "last_message_at": "2026-09-07T10:32:18.000Z",
        "total_tokens": 15420,
        "model": "anthropic/claude-opus-5.5",
        "total_cost_usd": 0.0928,
        "created_at": "2026-09-07T10:30:00.000Z",
        "updated_at": "2026-09-07T10:32:18.000Z"
      }
    }
  ],
  "pagination": {
    "first": "https://chat.betterstack.com/api/v2/chats?page=1",
    "last": "https://chat.betterstack.com/api/v2/chats?page=3",
    "prev": null,
    "next": "https://chat.betterstack.com/api/v2/chats?page=2"
  }
}
401

Unauthorized

Response body

{
  "errors": "Invalid authentication"
}

Response attributes

id
string

The ID of the chat.

type
string

Always chat.

attributes.team_id
integer

The ID of the team the chat belongs to.

attributes.team_name
string

The name of the team the chat belongs to.

attributes.name
string

The name of the chat.

attributes.status
string

Whether the agent is working on the chat: processing, awaiting_confirmation, or idle. Chat statuses explains each.

attributes.message_count
integer

The number of messages in the chat.

attributes.last_message_at
string or null

When the latest message was posted, as an ISO 8601 date-time in UTC, or null when the chat has no messages.

attributes.total_tokens
integer

The number of tokens the agent has used on the chat so far.

attributes.model
string or null

The model the chat runs on, such as anthropic/claude-opus-5.5, or null on chats created before model selection.

attributes.total_cost_usd
number

What the chat has cost so far, in US dollars.

attributes.created_at
string

When the chat was created, as an ISO 8601 date-time in UTC.

attributes.updated_at
string

When the chat was last updated, as an ISO 8601 date-time in UTC.

pagination.first
string

The URL of the first page of results. Read more about pagination.

pagination.last
string

The URL of the last page of results.

pagination.prev
string or null

The URL of the previous page, or null on the first page.

pagination.next
string or null

The URL of the next page, or null on the last page.

Example cURL

Example
curl --request GET \
  --url https://chat.betterstack.com/api/v2/chats \
  --header "Authorization: Bearer $TOKEN"


Previous article

Getting started with AI SRE API

Next article

Get a single chat