---
title: "Get all budgets"
method: GET
path: "/enterprises/{enterprise}/settings/billing/budgets"
tags: ["billing"]
---

# Get all budgets

`GET /enterprises/{enterprise}/settings/billing/budgets`

Gets budgets for an enterprise. Enterprise owners and billing managers can view all budgets, and organization administrators can view budgets scoped to organizations and repositories they administer. A custom role holder with fine-grained read access to enterprise billing can view non-repository budgets; repository-scoped budgets require the organization administrator permissions described above. An installation access token for a GitHub App installed on the enterprise with read access to enterprise billing can list all budgets in the enterprise.
Each page returns up to 100 budgets.

## Path parameters

- `enterprise` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `scope` 'enterprise' | 'organization' | 'repository' | 'cost_center' | 'multi_user_customer' | 'multi_user_cost_center' | 'user'
- `user` string

## Response `200`

Response when getting all budgets

- GetAllBudgets
  - `budgets` Budget[], required — Array of budget objects for the enterprise
    - `id` string, required — The unique identifier for the budget
    - `budget_type` union, required — The type of pricing for the budget
      - 'SkuPricing'
      - 'ProductPricing'
    - `budget_amount` integer, required — The budget amount limit in whole dollars. For license-based products, this represents the number of licenses.
    - `prevent_further_usage` boolean, required — The type of limit enforcement for the budget
    - `budget_scope` 'enterprise' | 'organization' | 'repository' | 'cost_center' | 'multi_user_customer' | 'multi_user_cost_center' | 'user', required — The scope of the budget
    - `budget_entity_name` string — The name of the entity for the budget (enterprise does not require a name).
    - `user` string — The user login when the budget is scoped to a single user (`user` scope).
    - `consumed_amount` number — The amount consumed for a user-scoped budget, or for a multi-user budget when filtering by user.
    - `budget_product_sku` string, required — A single product or sku to apply the budget to.
    - `budget_alerting` object, required
      - `will_alert` boolean, required — Whether alerts are enabled for this budget. Ignored for user-scope as alerting is disabled for them.
      - `alert_recipients` string[], required — Array of user login names who will receive alerts. Ignored for user-scope as alerting is disabled for them.
    - `expires_at` string, date — The date the budget will expire in `YYYY-MM-DD` format. Only dates in the future are accepted. If not provided, the budget will not expire. Only supported for budgets with `budget_scope` of `user`
  - `user` string — User login included when the response is scoped with the `user` query parameter.
  - `effective_budget` object — Effective user-level budget details returned when the response is scoped with the `user` query parameter.
    - `id` string, required — The unique identifier of the effective budget.
    - `budget_amount` integer, required — The budget amount for the effective budget.
    - `consumed_amount` number, required — The consumed amount for the specified user within the effective budget.
  - `has_next_page` boolean — Indicates if there are more pages of results available (maps to hasNextPage from billing platform)
  - `total_count` integer — Total number of budgets matching the query

## Other responses

- `403` — Forbidden
- `404` — Resource not found

## Changes

- **2026-08-27** `3e1f5bb781b4` — 1 info
  - added the optional property `budgets/items/expires_at` to the response with the `200` status
- **2026-08-06** `8ae6d0c8716e` — 1 info
  - added the optional property `budgets/items/consumed_amount` to the response with the `200` status
- **2026-06-30** `783a30335135` — 1 warning, 1 info
  - added the new `multi_user_cost_center` enum value to the `budgets/items/budget_scope` response property for the response status `200`
  - added the new enum value `multi_user_cost_center` to the `query` request parameter `scope`
- **2026-06-03** `1c5f737292e2` — 6 warning, 6 info
  - added the new `cost_center` enum value to the `budgets/items/budget_scope` response property for the response status `200`
  - added the new `enterprise` enum value to the `budgets/items/budget_scope` response property for the response status `200`
  - added the new `multi_user_customer` enum value to the `budgets/items/budget_scope` response property for the response status `200`
  - added the new `organization` enum value to the `budgets/items/budget_scope` response property for the response status `200`
  - …8 more

[Change history](https://skmtc.dev/github/apis/enterprise-cloud/changes/enterprises/:enterprise/settings/billing/budgets/get.md)

---

[API](https://skmtc.dev/github/apis/enterprise-cloud.md) · [All operations](https://skmtc.dev/github/apis/enterprise-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/github/enterprise-cloud/revisions/6020c72ba337/schema)