Sign in

v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,4581,08113.3 MB
billing

Get a budget by ID

Gets a budget by ID. The authenticated user must be an enterprise admin or billing manager.

get/enterprises/{enterprise}/settings/billing/budgets/{budget_id}

Path parameters

enterprisestring required

The slug version of the enterprise name.

budget_idstring required

The ID corresponding to the budget.

Response

Response when updating a budget

idstring required

ID of the budget.

budget_scope'enterprise' | 'organization' | 'repository' | 'cost_center' | 'multi_user_customer' | 'multi_user_cost_center' | 'user' required

The type of scope for the budget

budget_entity_namestring required

The name of the entity to apply the budget to

userstring

The user login when the budget is scoped to a single user (user scope).

budget_amountinteger required

The budget amount in whole dollars. For license-based products, this represents the number of licenses.

prevent_further_usageboolean required

Whether to prevent additional spending once the budget is exceeded

budget_product_skustring required

A single product or sku to apply the budget to.

Example response

{
  "budget_scope": "enterprise",
  "budget_entity_name": "octocat/hello-world",
  "user": "octocat",
  "prevent_further_usage": true,
  "budget_product_sku": "actions_linux",
  "budget_alerting": {
    "will_alert": true,
    "alert_recipients": [
      "mona",
      "lisa"
    ]
  }
}