Account

Get budget

GET /v1/account/budget
Permission
read:account
Tokens
API key, CLI user token, Session token

Read account and developer spend limits and current usage.

{
"as_of": str,
"credit_balance_usd": float,
"credit_exhausted": bool,
}

Response

alertsBudgetAlertsrequired

Notifications only. These thresholds do not stop paid requests.

as_ofstring, date-timerequired
credit_balance_usdnumberrequired
credit_exhaustedbooleanrequired
developer_limitsDeveloperBudgetsrequired
per_runSessionBudgetDefaultrequired
policyBudgetPolicyrequired

Limits on actual Ellipsis credit debits, not allocations of credit. Developer keys are attribution_type:attribution_id; API keys use their stable key ID, never the secret. Unattributed and Ellipsis bot activity is exempt only from developer limits. A null developer default disables that scope while preserving overrides for later use.

windowsarray<AccountBudgetWindow>required

On this page

No Headings
Schedule a demo