List Invoices
GET /invoices
Returns a paginated list of invoices for your company. Requires the invoice:read scope. Results are automatically filtered by test/live mode based on your API key. Supports filtering by status, currency, invoice number, and date range.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ”Filter by invoice state (e.g. draft, approved, sending, sent, delivered, failed, cancelled).
Filter by ISO 4217 currency code (e.g. EUR, USD).
Filter by exact invoice number as stored in UBL header.
Return invoices created on or after this date (ISO 8601, e.g. 2025-01-01).
Return invoices created on or before this date (ISO 8601, e.g. 2025-12-31).
Page number for pagination (15 results per page).
Responses
Section titled “ Responses ”Paginated list of invoices.
object
object
Unique invoice identifier (UUID).
UUID of the company that owns this invoice.
UUID of the user who created the invoice, if applicable.
Current workflow state: draft, approved, sending, sent, delivered, failed, or cancelled.
Invoice direction: outgoing (sent by company) or incoming (received).
Invoice total amount in cents.
ISO 4217 currency code (e.g. EUR, USD).
UBL specification version used. Peppol BIS 3.0 binds to UBL 2.1.
Full invoice data in structured UBL JSON format (header, seller, buyer, items, totals, etc.).
Additional metadata such as delivery details, error info, or processing history.
Delivery network used: peppol, ksef, or email.
UUID of the business entity (seller identity) used for this invoice.
ISO 8601 timestamp when the invoice was created.
ISO 8601 timestamp when the invoice was last updated.
ISO 8601 timestamp when the invoice was soft-deleted, or null.
API key is not associated with a company.