Pagination and errors

List endpoints support pagination with limit and skip query parameters.

Pagination parameters

integer

Number of items to return. The supported range is 1 to 50. The default is 30.

integer

Number of items to skip before returning results. Use this as an offset. The default is 0.

Paginated responses use a shared envelope:

{
  "items": [],
  "totalCount": 125,
  "limit": 30,
  "skip": 0
}

To request the next page, increase skip by the current limit.

curl "https://store.example.com/api/site/orders?limit=30&skip=30" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "User-Agent: OrderExporter/1.0"

Bosscart uses conventional HTTP status codes.

Status range	Meaning
`2xx`	The request succeeded.
`4xx`	The request was invalid, unauthorized, or referenced a missing resource.
`5xx`	The server could not process the request.

Error responses include a human-readable message:

{
  "success": false,
  "message": "Error message..."
}

Handle errors by checking both the HTTP status code and the response body.