---
title: "List Budgets"
method: GET
path: "/management/v1/budgets"
tags: ["budget management"]
---

# List Budgets

`GET /management/v1/budgets`

The budgets defined on this proxy, paged, sortable and filterable, for the
Budgets page.

Readable by a proxy admin or an admin viewer; anyone else is refused 403. The
older `/budget/list` answers with the whole table as a bare array and has no
way to page, sort or filter it.

`sort` takes a comma-separated list of `budget_id`, `max_budget`, `tpm_limit`,
`rpm_limit` or `created_at`, each optionally prefixed with `-` for descending,
and defaults to `-created_at`. `budget_id` is appended to every sort as the
tiebreaker. `q` is a case-insensitive substring match on `budget_id`.
`page_size` defaults to 50 and is capped at 100. Filters are
`filter[budget_duration][in|is_null]`, `filter[max_budget][gte|lte|is_null]`
and `filter[created_at][gte|lte]`.

Example curl:
```
curl --location --globoff 'http://0.0.0.0:4000/management/v1/budgets?sort=-max_budget&filter[budget_duration][in]=7d,30d&page_size=25'         --header 'Authorization: Bearer sk-1234'
```

## Response `200`

Successful Response

- ListResponseBudgetListItem
  - `data` BudgetListItem[], required
    - `budget_id` string, required
    - `max_budget` number, nullable
    - `soft_budget` number, nullable
    - `tpm_limit` integer, nullable
    - `rpm_limit` integer, nullable
    - `budget_duration` string, nullable
    - `budget_reset_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `meta` ListMeta, required — Page-mode counterpart to `PageMeta`: an entity list pays for the COUNT(*) so the table can show a page count.
    - `total_count` integer, required
    - `page` integer, required
    - `page_size` integer, required
    - `total_pages` integer, required
  - `links` ListLinks, required — Page-mode counterpart to `PageLinks`. `first`/`last` are knowable here because the total count is.
    - `self` string, required
    - `first` string, required
    - `prev` string, nullable
    - `next` string, nullable
    - `last` string, required

## Changes

- **2026-09-18** `082b5fabd909` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/management/v1/budgets/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/731afbea6a1b?raw)