Lucius API
Contracts

Get a contract

Retrieve a single contract by its external ID.

GET
/v1/billing/contracts/{ext_id}
AuthorizationBearer <token>

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

In: header

Path Parameters

ext_id*string

The external ID of the contract.

Response Body

application/json

application/json

application/json

curl -X GET "https://api.lucius.finance/v1/billing/contracts/acme-corp-2026"
{
  "object": "contract",
  "id": "acme-corp-2026",
  "customer_name": "Acme Corp",
  "status": "active",
  "start_date": "2026-01-01",
  "end_date": "2027-01-01",
  "currency": "USD",
  "metrics": [
    "revenue_amount_invoiced"
  ]
}

{
  "error": "Missing API key"
}

{
  "error": "Not found"
}