---
title: "Changes to Read balance"
method: GET
path: "/v1/accounts/{account-id}/balances"
---

# Changes to Read balance

`GET /v1/accounts/{account-id}/balances`

> Every recorded change to this endpoint, newest first.
> 50 revisions in range; 1 not diffed.

## Timeline

Changed in 4 of 50 revisions.

- **2021-02-19** `0d82c4699548` — 3 warning, 18 info
- **2021-02-10** `b51fe6ddb1fc` — 24 breaking, 22 warning, 6 info
- **2021-02-10** `3cc5b6a584f1` — 3 warning, 18 info
- **2021-02-10** `f324b23056bf` — 2 breaking, 1 warning, 4 info

## Changes

- **2021-02-19** `0d82c4699548` — 3 warning, 18 info
  - added the new `SCA_INVALID` enum value to the `additionalErrors/items/code` response property for the response status `400` (media type: application/problem+json)
  - added the new `SCA_INVALID` enum value to the `code` response property for the response status `400` (media type: application/problem+json)
  - added the new `SCA_INVALID` enum value to the `tppMessages/items/code` response property for the response status `400` (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `400` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `400` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `401` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `401` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `403` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `403` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `404` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `404` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `405` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `405` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `406` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `406` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `409` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `409` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `429` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `429` status (media type: application/problem+json)
  - added the optional property `account/cashAccountType` to the response with the `200` status
  - removed the `authorised` enum value from the `balances/items/balanceType` response property for the response status `200`
- **2021-02-10** `b51fe6ddb1fc` — 24 breaking, 22 warning, 6 info
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `400` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `401` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `403` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `404` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `405` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `406` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `409` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `429` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `400` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `401` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `403` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `404` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `405` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `406` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `409` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `429` (media type: application/problem+json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `400` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `401` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `403` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `404` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `405` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `406` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `409` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `429` (media type: application/json)
  - removed the optional property `_links/confirmation` from the response with the `400` status (media type: application/json)
  - removed the optional property `_links/confirmation` from the response with the `400` status (media type: application/problem+json)
  - removed the optional property `_links/confirmation` from the response with the `401` status (media type: application/json)
  - removed the optional property `_links/confirmation` from the response with the `401` status (media type: application/problem+json)
  - removed the optional property `_links/confirmation` from the response with the `403` status (media type: application/json)
  - removed the optional property `_links/confirmation` from the response with the `403` status (media type: application/problem+json)
  - removed the optional property `_links/confirmation` from the response with the `404` status (media type: application/json)
  - removed the optional property `_links/confirmation` from the response with the `404` status (media type: application/problem+json)
  - removed the optional property `_links/confirmation` from the response with the `405` status (media type: application/json)
  - removed the optional property `_links/confirmation` from the response with the `405` status (media type: application/problem+json)
  - removed the optional property `_links/confirmation` from the response with the `406` status (media type: application/json)
  - removed the optional property `_links/confirmation` from the response with the `406` status (media type: application/problem+json)
  - removed the optional property `_links/confirmation` from the response with the `409` status (media type: application/json)
  - removed the optional property `_links/confirmation` from the response with the `409` status (media type: application/problem+json)
  - removed the optional property `_links/confirmation` from the response with the `429` status (media type: application/json)
  - removed the optional property `_links/confirmation` from the response with the `429` status (media type: application/problem+json)
  - …12 more
- **2021-02-10** `3cc5b6a584f1` — 3 warning, 18 info
  - added the new `SCA_INVALID` enum value to the `additionalErrors/items/code` response property for the response status `400` (media type: application/problem+json)
  - added the new `SCA_INVALID` enum value to the `code` response property for the response status `400` (media type: application/problem+json)
  - added the new `SCA_INVALID` enum value to the `tppMessages/items/code` response property for the response status `400` (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `400` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `400` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `401` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `401` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `403` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `403` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `404` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `404` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `405` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `405` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `406` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `406` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `409` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `409` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `429` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `429` status (media type: application/problem+json)
  - added the optional property `account/cashAccountType` to the response with the `200` status
  - removed the `authorised` enum value from the `balances/items/balanceType` response property for the response status `200`
- **2021-02-10** `f324b23056bf` — 2 breaking, 1 warning, 4 info
  - for the `header` request parameter `PSU-Device-ID`, the format changed from no format to `uuid`
  - for the `header` request parameter `X-Request-ID`, the format changed from no format to `uuid`
  - removed the optional property `account/otherAccountIdentification` from the response with the `200` status
  - added the optional property `account/bban` to the response with the `200` status
  - added the optional property `account/maskedPan` to the response with the `200` status
  - added the optional property `account/msisdn` to the response with the `200` status
  - added the optional property `account/pan` to the response with the `200` status

---

[Operation](https://skmtc.dev/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework/docs/v1/accounts/:account-id/balances/get.md) · [API](https://skmtc.dev/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework.md) · [Page](https://skmtc.dev/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework/changes/v1/accounts/:account-id/balances/get)