Invoices

List invoices

get/invoices

Request

Base URL: https://api.lumabill.ch/v1
URL: https://api.lumabill.ch/v1/invoices
Auth: HTTP bearer

Query parameters

pageinteger

Page number (1-based)

per_pageinteger

Items per page (max 100)

document_type'invoice' | 'credit_note' | 'all'

invoice (default): sales only. credit_note: credit notes (Gutschriften, negative totals). all: both.

status'draft' | 'sent' | 'paid' | 'overdue'

Filter by status

client_idstring uuid

Filter by client UUID

Response

A paginated list of invoices

Example response

{
  "data": [
    {
      "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"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 50,
    "total": 243
  }
}

Changes

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