Pagination & sorting - Sentralbee Developer Docs

The list endpoints — products, orders, customers, collections, bundles and imports — return results one page at a time, so things stay fast even when there’s a lot of data. You control the page with a few query parameters:

Parameter	Default	What it does
`page`	`1`	Which page to fetch (starts at 1).
`limit`	`20`	How many items per page (1–100).
`sort_by`	`createdAt`	The field to sort by. Products and customers only.
`sort_order`	`desc`	`asc` for oldest first, `desc` for newest first. Products and customers only.

If any of these is out of range, you’ll get a 400 bad_request.

What comes back

Along with the items, each response tells you where you are in the list:

{
  "items": [ "… the resources on this page …" ],
  "page": 1,
  "size": 20,
  "total": 137,
  "total_pages": 7,
  "has_next_page": true,
  "has_previous_page": false
}

The one to watch is has_next_page: keep fetching the next page while it’s true, and stop once it’s false.

Example

curl "https://api.sentralbee.app/v1/products?page=1&limit=50&sort_order=desc" \
  -H "Authorization: Bearer sk_live_your_key_here"