Skip to content

Pagination

List endpoints (/brands, /collections, /channels) return paginated results. Control pagination with two query parameters:

ParameterTypeDefaultMinMaxDescription
pageinteger11-Page number to fetch.
per_pageinteger101100Items per page.

Requesting per_page outside the 1-100 range returns a 422 Unprocessable Entity with a validation error.

Every paginated response includes a pagination object:

{
"pagination": {
"currentPage": 1,
"perPage": 10,
"total": 8,
"lastPage": 1,
"nextPageUrl": null,
"prevPageUrl": null
}
}
  • total is the total number of items across all pages.
  • nextPageUrl and prevPageUrl are fully-formed URLs you can call directly, or null when there is no next/previous page.