List Invoices

Required scope: invoice:read

Lists invoices for one customer. Optionally restrict to one orderId or one integrationId. pageSize is capped at 100.

Generated Reference

POST /public-api/publicapi.v1.Invoice/ListInvoices

Lists invoices for one customer with bounded pagination.

Request ListInvoicesRequest

Response ListInvoicesResponse

ListInvoicesRequest

Field	Type	Description
customer_id	string	Customer whose invoices to list.
order_id	optional string	Restrict to invoices for one order.
integration_id	optional string	Restrict to invoices from one accounting integration.
page	int32	Zero-based page index.
page_size	int32	Page size, capped server-side.

ListInvoicesResponse

Field	Type	Description
invoices	repeated Invoice	Invoices on the requested page.
total	int32	Total invoices matching the filters.

Related Types

Invoice

Field	Type	Description
id	string
customer_id	string
order_id	string
order_version	int32
integration_id	string
business_state	InvoiceBusinessState
delivery_state	InvoiceDeliveryState
sync_state	InvoiceSyncState
total_minor	int64
currency	string
external_number	optional string
external_url	optional string
created_at	int64
updated_at	int64
lines	repeated InvoiceLine	Invoice line items, in document order.
invoice_date	optional int64	Invoice issue date as unix seconds, when set by the provider.
due_date	optional int64	Payment due date as unix seconds, when set by the provider.
sent_at	optional int64	Time the invoice was sent to the customer as unix seconds, when sent.

InvoiceLine

Field	Type	Description
description	string	Human-readable line description.
quantity	int32	Quantity billed on this line.
unit_price_minor	int64	Unit price in minor currency units (for example cents).
vat_rate	double	VAT rate applied to this line as a fraction (for example 0.21 for 21%).

Request

{
  "customerId": "<customer-id>",
  "orderId": "<order-id>",
  "page": 0,
  "pageSize": 50
}

Response

{
  "invoices": [
    {
      "id": "<invoice-id>",
      "orderId": "<order-id>",
      "status": "PUBLIC_INVOICE_STATUS_SENT",
      "currency": "EUR",
      "sentAt": "1737939600"
    }
  ],
  "total": 1
}