---
title: "List the budget scenarios defined in this tenant (name, year, workflow status, pinned actuals version)"
method: GET
path: "/api/v1/get_budgets"
---

# List the budget scenarios defined in this tenant (name, year, workflow status, pinned actuals version)

`GET /api/v1/get_budgets`

## Request

- Base URL: `https://k-phi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://k-phi.com/api/v1/get_budgets`
- Auth: HTTP bearer

List the budget scenarios defined in this tenant (name, year, workflow status, pinned actuals version). Pass budget_id with include_drivers=true to get the full driver grid (driver → entity → period → value) of one scenario.

## Query parameters

- `budget_id` string
- `include_drivers` boolean

## Response `200`

OK

- object
  - `data` object
  - `meta` object
    - `api` string
    - `capability` string
    - `at` string

## Other responses

- `401`: No or invalid credential
- `403`: Scope, extension or Builder Mode refused
- `422`: The capability refused the input
- `429`: Rate or daily quota reached

---

[API](https://skmtc.dev/k-phi/apis/k-api.md) · [All operations](https://skmtc.dev/k-phi/apis/k-api/llms.txt) · [OpenAPI document](https://skmtc.dev/k-phi/apis/k-api/revisions/60b28690ec35?raw)