Lucius API
Contracts

Get active pricing program

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

GET
/v1/billing/contracts/{ext_id}/pricing
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/pricing"
{
  "object": "pricing_program",
  "contract": "acme-corp-2026",
  "version": 1,
  "effective_date": "2026-01-01",
  "rules": [
    {
      "id": "a1b2c3d4",
      "name": "Platform Subscription",
      "type": "subscription",
      "model": "flat",
      "amount": "2000",
      "currency": "USD",
      "frequency": "monthly"
    },
    {
      "id": "e5f6a7b8",
      "name": "Usage Fee",
      "type": "usage",
      "model": "percentage",
      "rate": 0.05,
      "metric": "revenue_amount_invoiced"
    }
  ]
}

{
  "error": "Missing API key"
}

{
  "error": "Not found"
}