List Conversations

Get a paginated list of conversations.

GET /conversations

cURL

curl --request GET \
  --url 'http://localhost:8000/conversations' \
  --header "Authorization: Bearer $STATESET_AGENTS_API_KEY"

200

{
  "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "timestamp": "2026-08-31T14:22:05Z",
  "total": 102,
  "page": 1,
  "page_size": 20,
  "has_next": false,
  "has_prev": false,
  "items": [
    {
      "conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "message_count": 0,
      "created_at": "2026-08-31T14:22:05Z",
      "last_message_at": "2026-08-31T14:22:05Z",
      "total_tokens": 0
    }
  ]
}

Get a paginated list of conversations.

Query parameters

page · integer

Page number

page_size · integer

Items per page

agent_id · string,null

Filter by agent ID

Response

ConversationListResponse-Input

request_id · string,null

Request tracking ID

timestamp · string (date-time)

Response timestamp

total · integer · required

Total number of items

page · integer

Current page number

page_size · integer

Items per page

has_next · boolean

Whether there are more pages

has_prev · boolean

Whether there are previous pages

items · ConversationSummary[]

List of conversations

Show ConversationSummary

conversation_id · string · required

Conversation identifier

agent_id · string · required

Associated agent ID

message_count · integer

Number of messages

created_at · string (date-time) · required

Creation timestamp

last_message_at · string (date-time),null

Last message timestamp

total_tokens · integer

Total tokens used

Status codes

Code	Meaning
200	List of conversations
401	Authentication required
422	Validation Error
429	Rate limit exceeded

cURL

curl --request GET \
  --url 'http://localhost:8000/conversations' \
  --header "Authorization: Bearer $STATESET_AGENTS_API_KEY"

200

{
  "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "timestamp": "2026-08-31T14:22:05Z",
  "total": 102,
  "page": 1,
  "page_size": 20,
  "has_next": false,
  "has_prev": false,
  "items": [
    {
      "conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "message_count": 0,
      "created_at": "2026-08-31T14:22:05Z",
      "last_message_at": "2026-08-31T14:22:05Z",
      "total_tokens": 0
    }
  ]
}