Skip to main content
List endpoints support both pagination styles. Pass ?cursor= from the previous response’s pagination.nextCursor. Cursor pagination is stable under concurrent writes — rows created or deleted while you paginate cannot shift your window.
Stop when nextCursor is absent or hasMore is false. A cursor only works with the sort it was issued for. If you send a cursor that is malformed, too long, or was issued for a different sort, you get a 400 with code INVALID_CURSOR instead of a page. Start again without a cursor, or keep the same sort while you page. Cursors returned by the API always stay valid.

Offset

Pass ?limit=&offset=; the response includes pagination.total and hasMore. Convenient for page-numbered UIs, but pages can shift if rows are inserted while you paginate.

Sorting

Use ?sort=field:direction, for example ?sort=created_at:asc. Allowed fields are listed per endpoint in the API Reference. Default: created_at:desc.