Pagination¶

List endpoints return results in pages using cursor-based pagination.

GET /v1/buckets/my-first-bucket/records?limit=20

Response

{
  "data": [
    { "name": "hello-world", "value": 42 },
    { "name": "second-record", "value": 7 }
  ],
  "next_cursor": "eyJpZCI6Mn0",
  "has_more": true
}

Pass next_cursor back as the cursor parameter to fetch the next page:

GET /v1/buckets/my-first-bucket/records?limit=20&cursor=eyJpZCI6Mn0

When has_more is false, there are no further pages.

Default and maximum page size¶

Parameter	Default	Maximum
`limit`	20	100

Iterating an entire bucket

The SDKs expose a paginator helper that walks every page for you — see the Python and JavaScript SDK docs.

Sorting¶

By default, records are returned in creation order. Override with sort:

GET /v1/buckets/my-first-bucket/records?sort=-created_at

A leading - reverses the sort direction.