v1

OpenAPI 3.1.02026-07-13252193.7 KB
Intake

Analyze an uploaded energy invoice

Accepts a single energy-invoice PDF (multipart/form-data, field 'file'), validates it is a genuine energy invoice, extracts its structured figures (per-energy-type consumption, injection, billed cost, billing period, merchant, EAN), and — when annualize=true — also returns figures rescaled to a full year. A readable PDF that is not an energy invoice returns 200 with status 'rejected'. Nothing is stored: the consumer owns any persistence. Each non-2xx response is an RFC 7807 Problem whose type says exactly what went wrong — see the individual error responses below.

post/v1/invoices/analyze

Query parameters

annualizestring

When true, also return figures rescaled to a full year (365 days), per energy type, so a partial- or multi-year bill can be compared against yearly market contracts.

Response

Default Response

OR