Skip to main content

List budgets

Returns a cursor-paginated list of budgets for your organization.
string
Opaque pagination cursor. Pass next_cursor from a previous response to fetch the next page. Omit for the first page.
integer
default:"25"
Maximum items per page (1–100).

Request

Response


Get budget

Returns a single budget by ID.
string
required
Budget UUID.

Request

Response


Budget object

string
Unique budget identifier (UUID).
string
Organization that owns this budget.
string
Human-readable budget name.
string
Department this budget applies to. null for org-wide budgets.
number
Budget limit for the current period, in currency.
number
Amount consumed in the current period.
number
amount minus spent.
string
ISO 4217 currency code (e.g., USD).
string
Budget period: daily, weekly, monthly, quarterly, or annual.
boolean
When true, LLM requests are blocked once remaining reaches zero. When false, usage is allowed but an alert is triggered.
string
ISO 8601 creation timestamp.
string
ISO 8601 last-updated timestamp.
To create or modify budgets, use the dashboard under Budgets or the Terraform provider.