Pagination

Every list endpoint returns results in pages using cursor-based pagination. Cursors are object IDs, so paging stays stable even when objects are added or removed between requests.

Response Structure

List responses wrap results in a data array alongside a pagination object:

List response

{
  "data": [
    { "id": "snk_01kpb4n7arexs9cjf0ffmdtjry" }
  ],
  "pagination": {
    "starting_after": null,
    "limit": 10,
    "has_more": true,
    "next_cursor": "snk_01kpb4n7arexs9cjf0ffmdtjry"
  }
}

Field	Description
`starting_after`	The cursor this page was fetched with (`null` for the first page).
`limit`	Number of results per page.
`has_more`	Whether more results exist after this page.
`next_cursor`	Cursor to pass as `starting_after` for the next page.

Query Parameters

Parameter	Type	Default	Description
`limit`	integer	10	Results per page (1–50).
`starting_after`	string	—	Cursor: the ID of the last object on the previous page.

Paging Through Results

Omit starting_after to fetch the first page. For each subsequent page, pass the previous response’s next_cursor as starting_after. Stop when has_more is false, at which point next_cursor is null.

Fetch the first page

First page

curl "https://api.demo.cula.earth/tracking/v1/sinks?limit=20" \
  -H "Authorization: Bearer your_access_token_here" \
  -H "Cula-Organisation-Id: org_01k6cvp6bdeayb0hfrghfwxjzx"

Fetch the next page

Pass the previous response’s next_cursor as starting_after:

curl "https://api.demo.cula.earth/tracking/v1/sinks?limit=20&starting_after=snk_01kpb4n7arexs9cjf0ffmdtjry" \
  -H "Authorization: Bearer your_access_token_here" \
  -H "Cula-Organisation-Id: org_01k6cvp6bdeayb0hfrghfwxjzx"

Get Started

Guides

Response Structure

Query Parameters

Paging Through Results

​Response Structure

​Query Parameters

​Paging Through Results

Response Structure

Query Parameters

Paging Through Results