Pagination
Purpose
List endpoints paginate. Two styles appear in the public reference. Check the endpoint you are calling before assuming one shape.
Page numbers
Invoices, clients, and payments take:
| Query | Default | Limits |
|---|---|---|
page | 1 | minimum 1 |
limit | 20 | minimum 1, maximum 100 |
GET /api/invoices returns the page inside data.pagination:
{
"success": true,
"data": {
"invoices": [],
"pagination": { "total": 15, "page": 1, "limit": 20, "pages": 1 }
}
}
GET /api/clients returns the clients as the data array and puts total, page, and limit in the top-level meta object.
Cursors
Webhook endpoint and delivery lists use cursors:
| Query | Meaning |
|---|---|
limit | Page size. Default 10, maximum 100 |
starting_after | Return items after this id |
ending_before | Return items before this id |
The response includes has_more and total_count.