Pagination
List endpoints (/brands, /collections, /channels) return paginated results. Control pagination with two query parameters:
| Parameter | Type | Default | Min | Max | Description |
|---|---|---|---|---|---|
| page | integer | 1 | 1 | - | Page number to fetch. |
| per_page | integer | 10 | 1 | 100 | Items 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 }}totalis the total number of items across all pages.nextPageUrlandprevPageUrlare fully-formed URLs you can call directly, ornullwhen there is no next/previous page.