Lucius API
Invoices

Get invoice detail

Retrieve a single invoice with its line items. Line items are computed from rated charges and include subscription fees, one-time fees, and usage charges.

GET
/v1/billing/invoices/{number}

Authorization

AuthorizationBearer <token>

API key as Bearer token: Authorization: Bearer luc_live_...

In: header

Path Parameters

number*string

The invoice number (e.g. INV-2026-003).

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/billing/invoices/INV-2026-003"
{  "object": "invoice",  "number": "INV-2026-003",  "contract": "acme-corp-2026",  "status": "draft",  "subtotal": 2500,  "tax": 0,  "total": 2500,  "currency": "USD",  "billing_period": {    "start": "2026-03-01",    "end": "2026-03-31"  },  "issued_date": "2026-03-01",  "due_date": "2026-03-15",  "paid_date": null,  "metrics": [    "revenue_amount_invoiced"  ],  "line_items": [    {      "description": "Platform Subscription",      "quantity": 1,      "unit_price": 2000,      "amount": 2000    },    {      "description": "Usage Fee",      "quantity": 10000,      "unit_price": 0.05,      "amount": 500    }  ]}

{  "error": "Missing API key"}

{  "error": "Not found"}