# Get a single chat

Retrieves a specific chat by its ID, including its full transcript and any pending confirmations.

[endpoint]
base_url = "https://chat.betterstack.com"
path = "/api/v2/chats/{id}"
method = "GET"

[[path_param]]
name = "id"
description = "The ID of the chat to retrieve."
required = true
type = "string"

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

[responses]
[[response]]
status = 200
description = '''Returns the requested chat with its transcript and pending confirmations. The text of an AI message is the answer as markdown, and is null until the agent produces one.'''
body = '''{
  "data": {
    "id": "12345",
    "type": "chat",
    "attributes": {
      "team_id": 123456,
      "team_name": "example-team",
      "name": "Checkout 5xx spike",
      "status": "idle",
      "message_count": 2,
      "last_message_at": "2026-09-07T10:32:18.000Z",
      "total_tokens": 15420,
      "created_at": "2026-09-07T10:30:00.000Z",
      "updated_at": "2026-09-07T10:32:18.000Z",
      "messages": [
        {
          "id": 9001,
          "message_type": "user",
          "text": "Why did checkout start returning 5xx at 10:15?",
          "artifacts": [],
          "created_at": "2026-09-07T10:30:00.000Z",
          "user": null
        },
        {
          "id": 9002,
          "message_type": "ai",
          "text": "The 5xx responses come from checkout-api pods restarting after the 10:12 deploy of v2.4.0. The new version fails its readiness probe because PAYMENTS_URL is unset. Set it in the deployment manifest and roll out again.",
          "artifacts": [
            {
              "type": "report",
              "title": "Checkout 5xx investigation",
              "content": "Summary: the deploy of v2.4.0 at 10:12 dropped the PAYMENTS_URL variable from the checkout-api deployment. Pods fail their readiness probe and restart in a loop. Setting the variable and rolling out again restores checkout."
            }
          ],
          "created_at": "2026-09-07T10:32:18.000Z",
          "user": null
        }
      ],
      "pending_confirmations": []
    }
  }
}'''

[[response]]
status = 401
description = '''Unauthorized'''
body = '''{
  "errors": "Invalid authentication"
}'''

[[response]]
status = 404
description = '''Not Found'''
body = '''{
  "errors": "Resource with the provided ID was not found"
}'''
[/responses]

#### Example cURL

```shell
[label Example]
curl --request GET \
  --url https://chat.betterstack.com/api/v2/chats/12345 \
  --header "Authorization: Bearer $TOKEN"
```