API
Read the usage history
Sends and AI actions per day, and what pay as you go extras cost per month.
GET/billing/usage
Runs the real call on your workspace.
GET /billing/usage
Sends and AI actions per day, and what pay as you go extras cost per month.
Example
Needs billing:read. days goes back 1 to 3,660 days, 30 by default, and all goes back to the day the workspace was made. aiExtra counts the AI actions past the daily allowance, which pay as you go billed.
curl "$OE/billing/usage?days=7" -H "$AUTH"{ "object": "usage_history", "days": [ { "day": "2026-10-02", "aiActions": 14, "aiExtra": 0, "sends": 2210 }, { "day": "2026-10-03", "aiActions": 9, "aiExtra": 0, "sends": 1870 } ], "months": [ { "month": "2026-09", "extraSends": 3000, "extraAiActions": 0, "sendCents": 120, "aiCents": 0, "cents": 120 } ], "dailyAiActions": 150, "monthlySends": 200000}Only the owner of the workspace reaches billing: an API key, or an access token the owner connected with every address. A member’s token is a 403 owner_only, and a key or token limited to particular addresses or domains is a 422 capability_unsupported.