---
title: "Changes to GET /v1/time_off/balances"
method: GET
path: "/v1/time_off/balances"
---

# Changes to GET /v1/time_off/balances

`GET /v1/time_off/balances`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 12 of 20 revisions.

- **2026-03-19** `a896c17cf988` — 4 breaking, 1 info
- **2026-03-13** `6cfbdf910b80` — 1 warning
- **2026-03-09** `768d9cb8d8d9` — 2 breaking, 3 info
- **2026-03-09** `787281d7e9a2` — 1 info
- **2026-01-16** `d256b456551d` — 1 info
- **2026-01-05** `19dde65e3679` — 3 info
- **2026-01-04** `51a25af9420b` — 1 breaking
- **2025-12-26** `6296f9b186ea` — 1 info
- **2025-12-26** `fbc6e46bbea2` — 1 breaking
- **2025-12-26** `6296f9b186ea` — 1 info
- **2025-12-26** `fbc6e46bbea2` — 3 info
- **2025-12-24** `8d23b0949270` — 1 breaking, 2 info

## Changes

- **2026-03-19** `a896c17cf988` — 4 breaking, 1 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `403`
  - removed the required property `_tag` from the response with the `403` status
  - removed the required property `message` from the response with the `403` status
  - removed the required property `requiredPermissions` from the response with the `403` status
  - added `#/components/schemas/MissingRequiredPermissions, #/components/schemas/ApiNotEnabled` to the response body `anyOf` list for the response status `403`
- **2026-03-13** `6cfbdf910b80` — 1 warning
  - added the new `company:workplaces` enum value to the `requiredPermissions/items/scope` response property for the response status `403`
- **2026-03-09** `768d9cb8d8d9` — 2 breaking, 3 info
  - the `requiredPermissions/items/` response property's minItems was decreased from `2` to `0` for the response status `403`
  - the `requiredPermissions/items/` response's property type/format changed from `array`/`` to `object`/`` for status `403`
  - removed `subschema #1, subschema #2` from the `requiredPermissions/items/` response property 'prefixItems' list for the response status `403`
  - added the required property `requiredPermissions/items/level` to the response with the `403` status
  - added the required property `requiredPermissions/items/scope` to the response with the `403` status
- **2026-03-09** `787281d7e9a2` — 1 info
  - added the non-success response with the status `403`
- **2026-01-16** `d256b456551d` — 1 info
  - added the required property `count` to the response with the `200` status
- **2026-01-05** `19dde65e3679` — 3 info
  - added `subschema #1: startsWith("top_")` to the `id` response property `anyOf` list for the response status `404`
  - removed `subschema #1` from the `id` response property `anyOf` list for the response status `404`
  - the `data/items/policyId` response's property pattern `^top_` was added for the status `200`
- **2026-01-04** `51a25af9420b` — 1 breaking
  - response property `id` list-of-types was widened by adding types `number` to media type `application/json` of response `404`
- **2025-12-26** `6296f9b186ea` — 1 info
  - added the required property `data/items/id` to the response with the `200` status
- **2025-12-26** `fbc6e46bbea2` — 1 breaking
  - removed the required property `data/items/id` from the response with the `200` status
- **2025-12-26** `6296f9b186ea` — 1 info
  - added the required property `data/items/id` to the response with the `200` status
- **2025-12-26** `fbc6e46bbea2` — 3 info
  - added the new optional `query` request parameter `afterId`
  - added the new optional `query` request parameter `beforeId`
  - added the new optional `query` request parameter `limit`
- **2025-12-24** `8d23b0949270` — 1 breaking, 2 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - added the required property `data` to the response with the `200` status
  - added the required property `hasMore` to the response with the `200` status

---

[Operation](https://skmtc.dev/teamwarp/apis/warp-api/docs/v1/time_off/balances/get.md) · [API](https://skmtc.dev/teamwarp/apis/warp-api.md) · [Page](https://skmtc.dev/teamwarp/apis/warp-api/changes/v1/time_off/balances/get)