Customers
What each customer_id cost you this month, ready to bill from, and each one's lifetime balance.
July 2026 OctoberSeptemberAugustJulyJuneMay
| Customer | Est. cost | Calls | Tokens | Top line | |
|---|---|---|---|---|---|
| acme-corp | $46.70 | 7,200 | 15,120,000 | support-triage · claude-sonnet-4-5 |
Report |
| globex | $28.60 | 4,700 | 9,870,000 | lead-enricher · gemini-2.5-flash |
Report |
| initech | $28.00 | 3,000 | 6,300,000 | research-bot · claude-sonnet-4-5 |
Report |
| umbrella | $7.30 | 1,000 | 2,100,000 | sdr-writer · gpt-4.1 |
Report |
| Total | $110.60 | 15,900 |
Calendar month, UTC. Est. cost is an estimate at public list price over priced calls, from the same figures as GET /usage: your provider's invoice may differ. The CSV has one line per customer, agent and model.
Balances lifetime, per customer_id
| Customer | Share of units · all customers | Units used | Limit | Left | State |
|---|---|---|---|---|---|
| cust_umbrella | 9,310 | no limit | no limit | ok | |
| cust_acme | 4,820 | 5,000 | 180 | ok | |
| cust_globex | 2,140 | 5,000 | 2,860 | ok | |
| cust_initech | 1,000 | 1,000 | 0 | at limit |
4 customers, heaviest first. Heaviest is the list-price estimate where a customer has priced calls, then units. Units used, limit and left are each customer's lifetime balance in the units and tokens your code reported, and share is of every customer's units on this account, including any not listed. A job whose ceiling is in dollars never moves that balance: its spend is in Est. cost, at public list price over priced calls only, and it is bounded by its own ceiling, not by a customer limit. The full list is on GET /customers.
GET /decisions for refusals, /tasks for budgets and /tasks/:task_ref for a job's list-price estimate, /usage?by=event_type for the split by event_type and its estimate, /customers for balances, /keys for keys, each with Authorization: Bearer <your key>.