---
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`

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 sk-1234'
```

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-09-18** `082b5fabd909` — 1 info
  - endpoint added

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

---

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