# Get chat status

Returns the status of a chat without its transcript. Poll this endpoint after you [create a chat](https://betterstack.com/docs/ai-sre/api/chats/create/) or [reply to it](https://betterstack.com/docs/ai-sre/api/chats/reply/).

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

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

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

[responses]
[[response]]
status = 200
description = '''Returns the chat status and any pending confirmations. See [Chat statuses](#chat-statuses) below for what each status means.'''
body = '''{
  "data": {
    "id": "12345",
    "type": "chat_status",
    "attributes": {
      "status": "awaiting_confirmation",
      "pending_confirmations": [
        {
          "id": 501,
          "tool_name": "Bash",
          "tool_input": {
            "command": "kubectl rollout restart deployment/checkout-api -n production"
          },
          "status": "pending",
          "resolution_note": null,
          "expires_at": "2026-09-07T11:31:05.000Z",
          "confirmed_at": null,
          "created_at": "2026-09-07T10:31:05.000Z"
        }
      ]
    }
  }
}'''

[[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/status \
  --header "Authorization: Bearer $TOKEN"
```

## Chat statuses

| Status | What it means |
|---|---|
| `processing` | The agent is working on the latest message. Poll again in a few seconds. |
| `awaiting_confirmation` | The agent wants to run a tool that needs your approval and waits for you. [Approve or deny](https://betterstack.com/docs/ai-sre/api/chats/resolve-confirmation/) each confirmation listed in `pending_confirmations`. The agent then continues and the status returns to processing. |
| `idle` | The turn is over. [Get the chat](https://betterstack.com/docs/ai-sre/api/chats/get/) to read the answer, or [reply](https://betterstack.com/docs/ai-sre/api/chats/reply/) to continue. |