Skip to content

ConceptsPagination

Pagination

List endpoints return one page at a time, with a cursor for the next one. Each endpoint sets its own order. Attention queues can be oldest first, so an agent handles the message that has waited longest before the others.

Last updated

Query parameters

ParameterTypeDescription
cursorstringOpaque cursor from a previous response. Leave it out for the first page. Do not parse it, edit it or build one yourself.
limitintegerNumber of items per page. Default 25, max 100.

Response format

{
  "data": [ ... ],
  "pagination": {
    "next_cursor": "eyJjcmVhdGVkX2F0Ijoi...",
    "has_more": true,
    "limit": 25
  }
}

Iterating pages

Pass the next_cursor value as the cursor query parameter to get the next page. Stop when has_more is false.

Use a cursor only with the operation that returned it. Some cursors are tied to a mailbox, a time cutoff, a sort and filters. On later pages, leave those filters out or repeat them exactly. A cursor that does not match returns a validation error instead of quietly returning different results.

GET /v1/domains?limit=10
GET /v1/domains?limit=10&cursor=eyJjcmVhdGVkX2F0Ijoi...