---
title: "Get Account Budget"
method: GET
path: "/v1/account/budget"
tags: ["v1"]
---

# Get Account Budget

`GET /v1/account/budget`

## Request

- Base URL: `https://api.ellipsis.dev`
- URL: `https://api.ellipsis.dev/v1/account/budget`
- Auth: HTTP bearer

Get prepaid credit, actual trailing budgets, and developer/API-key limits.

Budgets cover the trailing 1, 7 and 28 days; they do not replenish
prepaid credit. Amounts include measured usage from active sessions.
Each paid LLM request requires positive credit and budget headroom.
An admitted request can overshoot.

## Headers

- `user-agent` string, nullable

## Response `200`

Successful Response

- BudgetSummary: Prepaid credit and the actual trailing budgets enforced by the proxy. Budget windows roll continuously; they are not monthly credit renewals. Amounts are in millicents and may be negative after overshoot. One admitted request can exceed a limit.
  - `alerts` BudgetAlerts, required: Notifications only. These thresholds do not stop paid requests.
    - `absolute_thresholds` BudgetAlertThresholds, required: Independent notification thresholds in millicents. Null disables a window.
      - `day` integer, nullable
      - `month` integer, nullable
      - `week` integer, nullable
    - `percent_thresholds` integer[], required
  - `as_of` string, date-time, required
  - `credit_balance` integer, required
  - `credit_exhausted` boolean, required
  - `developer_limits` DeveloperBudgets, required
    - `defaults` DeveloperBudgetDefaultWindow[], required
      - `limit` integer, required
      - `platform_max` integer, required
      - `window_days` integer, required
    - `developers` DeveloperBudget[], required: Developers with recent usage or overrides, plus active API keys.
      - `attribution_id` string, required
      - `attribution_type` 'github_user' | 'linear_user' | 'slack_user' | 'api_key', required
      - `avatar_url` string, nullable, required
      - `developer_key` string, required
      - `login` string, nullable, required
      - `name` string, nullable, required: API key name, when the key still exists.
      - `windows` DeveloperBudgetWindow[], required
        - `exhausted` boolean, required
        - `limit` integer, nullable, required
        - `override` integer, nullable, required
        - `remaining` integer, nullable, required
        - `spent` integer, required
        - `window_days` integer, required
    - `enabled` boolean, required
  - `per_run` SessionBudgetDefault, required
    - `budget` integer, required
    - `ceiling` integer, required: Current effective session ceiling from /account/settings.
    - `platform_max` integer, required
  - `policy` BudgetPolicy, required: Limits on actual spend, including subscription tokens, 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.
    - `account` BudgetLimits, required: Spending ceilings over trailing 1, 7 and 28 days, in millicents. Each is at least 100,000 ($1) and a whole number of cents.
      - `day` integer, required
      - `month` integer, required
      - `week` integer, required
    - `default_session` integer, required
    - `developer_defaults` BudgetLimits, required: Spending ceilings over trailing 1, 7 and 28 days, in millicents. Each is at least 100,000 ($1) and a whole number of cents.
      - `day` integer, required
      - `month` integer, required
      - `week` integer, required
    - `developer_overrides` object, required
  - `windows` AccountBudgetWindow[], required
    - `exhausted` boolean, required
    - `fraction_used` number, required
    - `limit` integer, required
    - `platform_max` integer, required
    - `remaining` integer, required
    - `spent` integer, required
    - `window_days` integer, required: Trailing window length: 1, 7 or 28 days.

## Other responses

- `401`: The bearer token is missing, invalid, or revoked.
- `403`: The credential may not perform this action, or the account is blocked.
- `422`: Validation Error

---

[API](https://skmtc.dev/ellipsis/apis/ellipsis-rest-api.md) - [All operations](https://skmtc.dev/ellipsis/apis/ellipsis-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ellipsis/apis/ellipsis-rest-api/revisions/344b16df9a1a?raw)