Skip to main content
GET
List the caller's Extract chats
The caller’s Extract chats (extract-* workflows). Deep Reader threads are not in this list.

Authorizations

Authorization
string
header
required

Organisation API key from Settings → API / /api/keys/. The secret is shown once. Send Authorization: Bearer sk-abacus-…. One active key per organisation. Ingest (/api/v2/ingest/*) refuses API keys — that surface is Auth0-only with ingest:read / ingest:write scopes.

Query Parameters

created_since
string<date-time>

created_at >= this ISO-8601 instant.

has_attachment
boolean

Only chats with / without attached or linked documents.

has_batch
boolean

Only chats with / without attached batches.

order
string

Sort field: ±updated_at / ±created_at / ±title. Default -updated_at.

page
integer

1-indexed page number. Defaults to 1.

page_size
integer

Rows per page. Defaults to 24; clamped to [1, 100].

q
string

Case-insensitive substring match on title.

updated_since
string<date-time>

updated_at >= this ISO-8601 instant.

workflow_type
string

Exact Extract workflow slug filter.

Response

200 - application/json

Top-level response shape for GET /api/v2/chats/.

Page-based pagination mirroring BatchPickerResponseSerializer so the SPA can reuse one paging widget across the batch and chat lists. has_more is server-computed (offset + len(page) < total) rather than inferred client-side, which would be wrong for a partial last page.

chats
object[]
required
page
integer
required
Required range: x >= 1
page_size
integer
required
Required range: x >= 1
total
integer
required
Required range: x >= 0
has_more
boolean
required