---
title: "Get budget"
method: GET
path: "/public/v1/budgets/{budget_id}/"
tags: ["Budgets"]
---

# Get budget

`GET /public/v1/budgets/{budget_id}/`

Retrieve a specific budget by ID with all related data.

## Path parameters

- `budget_id` integer, required

## Response `200`

OK

- PublicBudgetSchemaOut
  - `id` integer, required
  - `code` string, nullable
  - `name` string, required
  - `company_id` integer, nullable, required
  - `company_name` string, required
  - `budget_type` 'income_statement' | 'balance_sheet', required
  - `calendar_year` integer, required
  - `start_date` string, date, required
  - `end_date` string, date, required
  - `record_status` 'draft' | 'posted' | 'archived', required
  - `actuals_offset_in_months` integer, nullable
  - `classifications` PublicBudgetClassificationSchemaOut[]
    - `id` integer, required
    - `name` string, required
    - `line_id` integer, required
    - `line_name` string, required
  - `updated_at` string, date-time, required

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

## Changes

> 26 revisions in range; 1 not diffed.

- **2026-09-09** `456ef8c02f62` — 1 info
  - added the optional property `code` to the response with the `200` status

[Change history](https://skmtc.dev/dualentry/apis/dualentry-public-api-2/changes/public/v1/budgets/:budget_id/get.md)

---

[API](https://skmtc.dev/dualentry/apis/dualentry-public-api-2.md) · [All operations](https://skmtc.dev/dualentry/apis/dualentry-public-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/dualentry/apis/dualentry-public-api-2/revisions/91438f9a065f?raw)