Supplier invoices
Invoices your customer has received — what they are billed for.
This is the utility and supplier side of the platform: electricity, water, gas, telecoms and any billing portal an engine can read. Each invoice carries its number and dates, the issuer, the amounts and taxes, the consumption or concepts billed, and whether the original document is available.
The document is a separate call. Each invoice carries attachments — references to the files the provider issued, by id — and you download each one with Download a document. An invoice with an empty attachments had no document to keep.
Requires the supplier_invoices_read feature
Features are chosen when the execution starts, not here. An execution that did not ask for supplier_invoices_read answers 204, and the only way to get the data is to run another one.
How far back the billing history goes is set in that feature’s configuration and bounded by what the provider publishes.
Server to server only. This call is authorised with your application secret: it belongs in your backend, never in a browser, a mobile app or anything your customer can read.
Authentication
Path parameters
Response
200 OK
The invoices your customer receives — what they are billed, by whom, for which period and with what taxes. The PDF behind each one is downloaded separately.
An empty list is an answer, not a gap: the feature ran and the source reported none.
Invoice ID for the current execution. Note: it may change between executions.