---
title: "Get Access Group Budget"
method: GET
path: "/access_group/{access_group}/budget"
tags: ["model management"]
---

# Get Access Group Budget

`GET /access_group/{access_group}/budget`

## Request

- Base URL: `https://api.sea-lion.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sea-lion.ai/access_group/{access_group}/budget`
- Auth: API key in header `x-litellm-api-key`

Get the shared budget of an access group, and the spend drawn against it.

Example:
```bash
curl -X GET 'http://localhost:4000/access_group/production-models/budget' \
  -H "Authorization: Bearer $LITELLM_MASTER_KEY"
```

Parameters:
- access_group: str - The access group name (URL path parameter)

Returns:
- AccessGroupBudgetResponse; budget is null when the group has no budget set

Raises:
- HTTPException 404: If access group not found

## Path parameters

- `access_group` string, required

## Response `200`

Successful Response

- AccessGroupBudgetResponse
  - `access_group` string, required
  - `spend` number, required
  - `budget` AccessGroupBudget
    - `budget_id` string, required
    - `max_budget` number, nullable
    - `soft_budget` number, nullable
    - `budget_duration` string, nullable
    - `budget_reset_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `f2fb14eab3f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sea-lion/apis/litellm-api/changes/access_group/:access_group/budget/get.md)

---

[API](https://skmtc.dev/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.dev/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sea-lion/apis/litellm-api/revisions/1ba9123c189a?raw)