---
title: "Get budget details"
method: GET
path: "/api/v1/budgets/{id}/details"
tags: ["Finance Management.Budgets", "ENTERPRISE"]
---

# Get budget details

`GET /api/v1/budgets/{id}/details`

Get the specified budget and its periods within the start and end
dates. The date parameters are inclusive, thus specifying a date in
the middle of a period will include the complete period amounts.

## Path parameters

- `id` string, required

## Query parameters

- `start` integer
- `end` integer

## Response `200`

A Successful response

- GetBudgetDetailsResponse
  - `averageSpentAmount` Amount, required
    - `currencyCode` string, required — The ISO 4217 currency code of the amount
    - `scale` integer, required — The scale of the amount. The `unscaledValue` is used with `scale` to accurately represent floating point values. The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
    - `unscaledValue` integer, required — The unscaled value of the amount. The `unscaledValue` is used with `scale` to accurately represent floating point values. The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
  - `budgetPeriods` BudgetPeriod[] — List of budget periods.
    - `end` integer — Period start expressed as UTC epoch timestamp in milliseconds.
    - `spentAmount` Amount, required
      - `currencyCode` string, required — The ISO 4217 currency code of the amount
      - `scale` integer, required — The scale of the amount. The `unscaledValue` is used with `scale` to accurately represent floating point values. The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
      - `unscaledValue` integer, required — The unscaled value of the amount. The `unscaledValue` is used with `scale` to accurately represent floating point values. The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
    - `start` integer — Period start expressed as UTC epoch timestamp in milliseconds.
  - `budgetSpecification` Finance20ManagementBudgets — unresolved $ref
  - `end` integer — Last period end expressed as UTC epoch timestamp in milliseconds.
  - `start` integer — First period start expressed as UTC epoch timestamp in milliseconds.
  - `totalSpentAmount` Amount, required
    - `currencyCode` string, required — The ISO 4217 currency code of the amount
    - `scale` integer, required — The scale of the amount. The `unscaledValue` is used with `scale` to accurately represent floating point values. The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
    - `unscaledValue` integer, required — The unscaled value of the amount. The `unscaledValue` is used with `scale` to accurately represent floating point values. The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.

## Other responses

- `401` — If the user is not authorized.
- `404` — Budget not found
- `500` — For any unspecified error

---

[API](https://skmtc.net/tink/apis/tink-api.md) · [All operations](https://skmtc.net/tink/apis/tink-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tink/tink-api/revisions/23d8982b533d/schema)