Skip to main content

List Invoices

Retrieve a paginated list of invoices.

Endpoint

GET /invoices

Authentication

Bearer Token (passed in the Authorization header)

Request Parameters

Query Parameters

ParameterTypeRequiredDefaultDescription
sizeintegerNo20The number of invoices to return per page.
pageintegerNo0The page number to retrieve (zero-indexed).
sortstringNoThe field to sort by. Prefix with - for descending order.
statusstringNoFilter by invoice status.
customerIdstringNoFilter by customer unique identifier.
companyIdstringNoFilter by company unique identifier.
fromDatestring (date)NoFilter invoices created on or after this date (ISO 8601 format).
toDatestring (date)NoFilter invoices created on or before this date (ISO 8601 format).

Request Headers

HeaderValueRequiredDescription
AuthorizationBearer {token}YesBearer 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.