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}
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://api.lucius.finance/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"
}