Lucius API
Contracts

Get a contract

Retrieve a single contract by its external ID.

GET
/v1/billing/contracts/{ext_id}

Authorization

AuthorizationBearer <token>

API key as Bearer token: Authorization: Bearer luc_live_.... Create keys in the dashboard under Settings > API Keys.

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://example.com/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"}

Create a sample test contract POST

POST /v1/billing/contracts with `{ customer_id }`. Lucius generates the contract id, a sample CSA, and usage metrics `domestic_wire` and `international_wire`.

Get active pricing program GET

Returns the currently active (approved) pricing program for a contract, including all pricing rules.