---
title: "Get all budgets for an organization"
method: GET
path: "/organizations/{org}/settings/billing/budgets"
tags: ["billing"]
---

# Get all budgets for an organization

`GET /organizations/{org}/settings/billing/budgets`

> [!NOTE]
> This endpoint is in public preview and is subject to change.

Gets all budgets for an organization. The authenticated user must be an organization admin or billing manager.
Each page returns up to 10 budgets.

## Path parameters

- `org` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `scope` 'enterprise' | 'organization' | 'repository' | 'cost_center'

## 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` string, required — The scope of the budget (enterprise, organization, repository, cost center)
    - `budget_entity_name` string — The name of the entity for the budget (enterprise does not require a name).
    - `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
      - `alert_recipients` string[], required — Array of user login names who will receive alerts
  - `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
- `500` — Internal Error

## Changes

- **2026-03-10** (2022-11-28) `5607301d0482` — 2 breaking, 2 info
  - added `subschema #1, subschema #2` to the `budgets/items/budget_type` response property `oneOf` list for the response status `200`
  - the `budgets/items/budget_type` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - removed the `ProductPricing` enum value from the `budgets/items/budget_type` response property for the response status `200`
  - removed the `SkuPricing` enum value from the `budgets/items/budget_type` response property for the response status `200`

[Change history](https://skmtc.dev/github/apis/rest/changes/organizations/:org/settings/billing/budgets/get.md)

---

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