Cursor (recommended)
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.
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.