Pagination

List endpoints return paginated results using cursor-based pagination. Use the cursor and limit query parameters to navigate through results.

Query Parameters

cursor

string

Opaque cursor returned from a previous request. Pass this to fetch the next page of results.

limit

number

default:"20"

Number of items to return per page. Maximum value is 100.

Every paginated response includes:

{
  "data": [...],
  "nextCursor": "eyJpZCI6IjEyMzQ1In0",
  "hasMore": true
}

Field	Type	Description
`data`	array	The page of results.
`nextCursor`	string \| null	Cursor to pass as the `cursor` query parameter for the next page. `null` if there are no more results.
`hasMore`	boolean	`true` if there are additional pages after this one.

Fetch the first page:

curl https://api.tusky.io/v2/environments?limit=10 \
  -H "Api-Key: YOUR_API_KEY"

Fetch the next page using the returned cursor:

curl "https://api.tusky.io/v2/environments?limit=10&cursor=eyJpZCI6IjEyMzQ1In0" \
  -H "Api-Key: YOUR_API_KEY"

Keep paginating until hasMore is false or nextCursor is null to retrieve all results.