Skip to main content
GET
/
v1
/
chats
List Chats
curl --request GET \
  --url https://api.cuadra.ai/v1/chats \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "organizationId": "<string>",
      "id": "<string>",
      "modelId": "<string>",
      "title": "Product Support",
      "model": {
        "contextWindow": 128000,
        "createdAt": "2025-09-08T06:33:19Z",
        "creditMultiplier": 2,
        "description": "Advanced language model for complex tasks",
        "displayName": "large-model Omni",
        "enabled": true,
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "isRecommended": true,
        "isSystemModel": false,
        "lifecycleState": "active",
        "maxTokensPerRequest": 4096,
        "metadata": {},
        "modelName": "large-modelo",
        "provider": "provider-a",
        "supportsStreaming": true,
        "updatedAt": "2025-09-08T06:33:19Z"
      },
      "status": "generating",
      "deletedAt": "2024-01-20T10:00:00Z"
    }
  ],
  "nextCursor": "<string>",
  "hasMore": false,
  "totalCount": 123
}

Authorizations

​
Authorization
string
header
required

JWT token from Stytch B2B authentication (magic link, SSO, or M2M)

Query Parameters

​
expand[]
string[] | null

List of related objects to expand in the response. Example: ?expand[]=model&expand[]=versions

Example:
["model"]
​
limit
integer
default:20
Required range: 1 <= x <= 100
​
cursor
string | null

Opaque cursor

Response

Successful Response

Paginated list of chat summaries.

​
items
ChatSummaryOut · object[]
required

List of chat summaries

​
nextCursor
string | null

Cursor for the next page of results.

​
hasMore
boolean
default:false

Whether there are more results available.

​
totalCount
integer | null

Total count of chats