Contracts
Get active pricing program
Returns the currently active (approved) pricing program for a contract, including all pricing rules.
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://example.com/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"}Get a contract GET
Retrieve a single contract by its external ID.
Add a pricing rule POST
Appends a new pricing rule to the contract's active program, creating a new approved pricing program version (append-only; prior versions are preserved). Use this to set up counterparty-scoped rules — e.g. waiving the maker fee for a specific counterparty — before submitting usage.