Pagination
Signed cursors and page metadata.
The shared list contract uses cursor-based pagination. A list request accepts an optional
cursor and a limit between 1 and 100, defaulting to 50. Return a cursor unchanged;
it is opaque, signed, and valid for 24 hours.
List responses contain data, request_id, and pagination with:
| Field | Meaning |
|---|---|
next_cursor | Cursor for the next request, or null. |
has_more | Whether there are more results. |
as_of | UTC timestamp describing the page's freshness. |
The optional source field is primary or replica. For a replica, as_of describes
its last replayed heartbeat. A cursor binds to company, test/live mode, route, sort,
and filters; changing those inputs invalidates the cursor.
Pages are not a fixed snapshot. Moving sort keys can cause a record to appear on both pages or neither. Stable list exports are not yet available in the current public route set.
Resource list endpoints using this contract are not yet available. The current company
membership response is a companies array and does not use cursor pagination.