---
title: "Get a budget's baseline history (the frozen amount steps from activation onward)"
method: GET
path: "/v1/org/{orgId}/budget/{budgetId}/baseline-history"
tags: ["budget"]
---

# Get a budget's baseline history (the frozen amount steps from activation onward)

`GET /v1/org/{orgId}/budget/{budgetId}/baseline-history`

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/v1/org/{orgId}/budget/{budgetId}/baseline-history`
- Auth: none declared
- TypeScript: <https://skmtc.dev/charthop/apis/charthop-api/docs/v1/org/:orgId/budget/:budgetId/baseline-history/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `orgId` string, required
- `budgetId` string, required

## Response `200`

ok

- BaselineHistoryEntry[]
  - `value` Money
    - `amount` number, required
    - `currency` string, required
    - `places` integer
  - `date` string, date, required: effective date of this baseline value
  - `userId` string, required: user who set this baseline value
  - `eventId` string, required: event that recorded this baseline value

## Other responses

- `400`: bad request
- `401`: not authorized
- `404`: not found

## Changes

- **2026-08-05** `b1eb05de45cd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/charthop/apis/charthop-api/changes/v1/org/:orgId/budget/:budgetId/baseline-history/get.md)

---

[API](https://skmtc.dev/charthop/apis/charthop-api.md) - [All operations](https://skmtc.dev/charthop/apis/charthop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/charthop/apis/charthop-api/revisions/9ba478cf5ae1?raw)