Pagination & sorting

Working through long lists.

The list endpoints — products, orders, and customers — 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.
sort_order	desc	asc for oldest first, desc for newest first.

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"