Pagination & filtering
All list endpoints share the same query parameters for pagination, sorting, filtering and free-text search. Malformed parameter values are rejected with 400 invalid_request.
Pagination
| Parameter | Default | Limits | Description |
|---|---|---|---|
page | 1 | min 1 | 1-based page number. |
per_page | 50 | 1–200 | Items per page. |
curl "https://app.talero.dk/api/v1/customers?page=3&per_page=100" \
-H "X-API-Key: $TALERO_API_KEY"List responses include a meta object; iterate until page reaches total_pages:
{
"data": [ ... ],
"meta": { "page": 3, "per_page": 100, "total": 342, "total_pages": 4 }
}Sorting
Use sort to pick a field and order to pick a direction (asc or desc; the default direction is desc). Each resource allows a fixed set of sort fields:
| Resource | Allowed sort fields | Default sort |
|---|---|---|
| Invoices | created_at, issue_date, due_date, total, invoice_number | created_at |
| Customers | name, created_at, email | name |
| Products | name, created_at, unit_price | name |
| Expenses | created_at, date, amount | created_at |
| Suppliers | name, created_at | name |
| Accounts | account_number, name, created_at | account_number |
| Transactions | date, created_at | date |
curl "https://app.talero.dk/api/v1/invoices?sort=due_date&order=asc" \
-H "X-API-Key: $TALERO_API_KEY"Filtering
status
The status filter is available on invoices and expenses only. Invoice statuses:
draft, approved, sent, paid, overdue, cancelled
curl "https://app.talero.dk/api/v1/invoices?status=overdue" \
-H "X-API-Key: $TALERO_API_KEY"since and until
Restrict results to a date range. Both take ISO 8601 dates (YYYY-MM-DD), are inclusive, and are validated — an unparsable date returns 400 invalid_request.
curl "https://app.talero.dk/api/v1/expenses?since=2026-01-01&until=2026-06-30" \
-H "X-API-Key: $TALERO_API_KEY"search
Case-insensitive free-text search over the resource's descriptive fields (for example customer name and email, or invoice number and notes):
curl "https://app.talero.dk/api/v1/customers?search=nordisk" \
-H "X-API-Key: $TALERO_API_KEY"Combining parameters
All parameters combine freely:
curl "https://app.talero.dk/api/v1/invoices?status=paid&since=2026-07-01&sort=total&order=desc&per_page=25" \
-H "X-API-Key: $TALERO_API_KEY"