Pagination
All list endpoints return paginated results with a consistent format.
Request Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
page | number | 1 | Page number (1-indexed) |
limit | number | 20 | Items per page (max 100) |
Response Format
{
"data": [...],
"pagination": {
"page": 1,
"limit": 20,
"total": 156,
"totalPages": 8,
"hasMore": true
}
}Fields
| Field | Description |
|---|---|
page | Current page number |
limit | Items per page |
total | Total matching items |
totalPages | Total number of pages |
hasMore | Whether there are more pages |
Example
# First page
GET /api/orders?page=1&limit=50
# Next page
GET /api/orders?page=2&limit=50Sorting
Most list endpoints support sorting via sort and order parameters:
GET /api/orders?sort=created_at&order=desc