Hermos API
Concepts

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:

FieldMeaning
next_cursorCursor for the next request, or null.
has_moreWhether there are more results.
as_ofUTC 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.