Invoices

Get an invoice

get/invoices/{id}

Request

  • Base URL: https://api.lumabill.ch/v1
  • URL: https://api.lumabill.ch/v1/invoices/{id}
  • Auth: HTTP bearer

Response

Invoice object

idstring uuid required
invoice_numberstring nullable required

null while the document is an unnumbered draft. Numbers are assigned when the document is first issued (leaves draft) and never removed afterwards.

client_idstring uuid required
status'draft' | 'sent' | 'paid' | 'overdue' required
issue_datestring date required
due_datestring date required
totalnumber double required

Total invoice amount including VAT

currency'CHF' | 'EUR' | 'USD' | 'GBP' | 'JPY' | 'CAD' | 'AUD' | 'SEK' | 'NOK' | 'DKK' | 'HUF' required

ISO 4217 code of a currency the API converts (ESTV/BAZG rates). The same list applies to every currency field of the API.

notesstring nullable
payment_termsstring nullable
created_atstring date-time required

Example response

{
  "id": "a1b2c3d4-1234-5678-abcd-ef0123456789",
  "invoice_number": "INV-2025-0042",
  "client_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "sent",
  "issue_date": "2025-05-01",
  "due_date": "2025-05-31",
  "total": 1296,
  "currency": "CHF",
  "lines": [
    {
      "description": "Web development - May 2025",
      "quantity": 8,
      "price": 150,
      "vat_rate": 8.1
    }
  ],
  "notes": "Payment within 30 days. Thank you for your business.",
  "payment_terms": "30 days net",
  "created_at": "2025-04-30T08:00:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.