List Invoices

GET /invoices

Returns a paginated list of invoices for the authenticated clinic.

Scope required: finance.read

Query Parameters

Parameter	Type	Description
patient_id	UUID	Filter by patient
status	string	draft | pending | sent | partially_paid | paid | overdue | cancelled | refunded
from	string	Start date — Y-m-d (by issue date)
to	string	End date — Y-m-d
page	integer	Default: 1
limit	integer	Default: 20, max: 100

Response 200

{
  "data": [
    {
      "id": "018b1c2d-3e4f-7a5b-c6d7-e8f9a0b1c2d3",
      "invoice_number": "INV-2026-0042",
      "status": "paid",
      "issue_date": "2026-01-10",
      "due_date": "2026-01-24",
      "paid_at": "2026-01-18T11:30:00+03:00",
      "currency": "TRY",
      "subtotal": 1500.00,
      "tax_amount": 270.00,
      "discount_amount": 0.00,
      "total_amount": 1770.00,
      "paid_amount": 1770.00,
      "balance_due": 0.00,
      "patient": {
        "id": "018f1a2b-…",
        "full_name": "Ali Yılmaz",
        "email": "ali@example.com"
      },
      "line_items": [],
      "created_at": "2026-01-10T09:00:00+03:00"
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1, "total_pages": 1 }
}