List expenses

get/expenses

Request

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

Query parameters

pageinteger

Page number (1-based)

per_pageinteger

Items per page (max 100)

from_datestring date

to_datestring date

vendor_idstring uuid

categorystring

paymentStatus'UNPAID' | 'PARTIALLY_PAID' | 'PAID'

Filter by payment status (use UNPAID to find outstanding obligations)

excludeMatchedboolean

If true, hide fully paid expenses; partially-paid expenses remain visible

Response

A paginated list of expenses

Example response

{
  "data": [
    {
      "id": "b2c3d4e5-2345-6789-bcde-f01234567890",
      "profile_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "vendor_id": "4fb96g75-6828-5673-c4gf-g12345678901",
      "description": "Office supplies - Q2 2025",
      "amount": 84.5,
      "currency": "CHF",
      "date": "2025-05-10",
      "category": "Office Supplies",
      "vat_rate": 8.1,
      "receipt_url": "https://files.lumabill.com/receipts/abc123.pdf",
      "created_at": "2025-05-10T14:00:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 50,
    "total": 243
  }
}

Changes

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