List Invoices
Retrieve a paginated list of invoices.
Endpoint
GET /invoices
Authentication
Bearer Token (passed in the Authorization header)
Request Parameters
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
size | integer | No | 20 | The number of invoices to return per page. |
page | integer | No | 0 | The page number to retrieve (zero-indexed). |
sort | string | No | — | The field to sort by. Prefix with - for descending order. |
status | string | No | — | Filter by invoice status. |
customerId | string | No | — | Filter by customer unique identifier. |
companyId | string | No | — | Filter by company unique identifier. |
fromDate | string (date) | No | — | Filter invoices created on or after this date (ISO 8601 format). |
toDate | string (date) | No | — | Filter invoices created on or before this date (ISO 8601 format). |
Request Headers
| Header | Value | Required | Description |
|---|---|---|---|
Authorization | Bearer {token} | Yes | Bearer token for authentication. |
Example Request
curl -X GET "https://api.example.com/invoices?size=20&page=0" \
-H "Authorization: Bearer {token}"
Request Schema
No request body is required for this endpoint.