---
title: "List workspace budgets"
method: GET
path: "/workspaces/{id}/budgets"
tags: ["Workspaces"]
---

# List workspace budgets

`GET /workspaces/{id}/budgets`

List all budgets configured for a workspace. [Management key](/docs/guides/overview/auth/management-api-keys) required.

## Path parameters

- `id` string, required — The workspace ID (UUID) or slug

## Response `200`

Budgets retrieved successfully

- ListWorkspaceBudgetsResponse
  - `data` WorkspaceBudget[], required — List of budgets configured for the workspace
    - `created_at` string, required — ISO 8601 timestamp of when the budget was created
    - `id` string, uuid, required — Unique identifier for the budget
    - `limit_usd` number, double, required — Spending limit in USD for this interval
    - `reset_interval` 'daily' | 'weekly' | 'monthly' | 'null', nullable, required — Interval at which spend resets. Null means a lifetime (one-time) budget.
    - `updated_at` string, required — ISO 8601 timestamp of when the budget was last updated
    - `workspace_id` string, uuid, required — ID of the workspace the budget belongs to
  - `include_byok_in_budgets` boolean — Whether BYOK (bring-your-own-key) spend is included when enforcing the workspace's budgets. This is a workspace-wide setting that applies to all budget intervals (daily, weekly, monthly, and lifetime).

## Other responses

- `401` — Unauthorized - Authentication required or invalid credentials
- `404` — Not Found - Resource does not exist
- `500` — Internal Server Error - Unexpected server error

---

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