Skip to documentation
Browse documentation

Follow opaque cursors until links.next is null

Collection endpoints default to 100 rows and accept at most 1,000 rows per page. A successful page contains data, meta, and links. The links.next value is either a complete next-page URL or null.

{
  "data": [],
  "meta": {
    "requestId": "4d34680e-64c8-44ec-994d-a1352c6569b4",
    "asOf": "2026-08-15T10:30:00.000Z"
  },
  "links": {
    "next": "https://api.data.hyran.co/v1/entities?cursor=opaque-value&limit=100"
  }
}

Cursor rules

  • Treat the cursor and the complete next link as opaque.
  • Do not decode, edit, compare, cache across query shapes, or manufacture a cursor.
  • Keep the original filters unchanged while following a page sequence.
  • Stop only when links.next is null.
  • Restart from the first page when the integration needs a new asOf view.

Filters and sorting

The API accepts only filters and sort options declared in OpenAPI. It rejects arbitrary field expressions, unrestricted joins, nested query languages, tenant IDs, and SQL.