Pagination

How list endpoints paginate results — query parameters and the Pagination object returned with every list response.

All list endpoints (e.g. "get orders") accept the same pagination query parameters and return the same pagination object alongside the results.

Query parameters

ParameterTypeRequiredDescription
pageintegernoPage number, starting at 1. Defaults to 1.
limitintegernoItems per page. Defaults to 20, max 100.

Pagination object

FieldTypeDescription
pageintegerCurrent page number.
limitintegerNumber of results per page.
totalintegerTotal number of matching results.
hasMorebooleantrue if there are additional pages.

Example

curl "https://api.usedecal.com/v0/orders?page=2&limit=50" \
  -H "Authorization: Bearer sk_live_your_api_key_here"
{
  "orders": [...],
  "pagination": {
    "page": 2,
    "limit": 50,
    "total": 137,
    "hasMore": true
  }
}