---
title: "List budgets"
method: GET
path: "/api/governance/budgets"
tags: ["Governance"]
---

# List budgets

`GET /api/governance/budgets`

Returns a list of all budgets. Use the `from_memory` query parameter to get data from in-memory cache.

## Query parameters

- `from_memory` boolean

## Response `200`

Successful response

- ListBudgetsResponse — List budgets response
  - `budgets` Budget[]
    - `id` string, required
    - `max_limit` number, required — Maximum budget in dollars
    - `reset_duration` string, required — Reset duration (e.g., "30s", "5m", "1h", "1d", "1w", "1M")
    - `calendar_aligned` boolean — When true, resets align to calendar period boundaries in UTC (not rolling from last reset)
    - `last_reset` string, date-time, required
    - `current_usage` number, required
    - `team_id` string — Team that owns this budget, when the budget is team-scoped
    - `virtual_key_id` string — Virtual key that owns this budget, when the budget is virtual-key-scoped
    - `provider_config_id` integer — Provider config that owns this budget, when the budget is provider-config-scoped
    - `config_hash` string, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `count` integer

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.net/getbifrost/apis/bifrost-api.md) · [All operations](https://skmtc.net/getbifrost/apis/bifrost-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbifrost/bifrost-api/versions/f8cab88f64ea/schema)