---
title: "Get all types of balances for the selected account."
method: GET
path: "/v1/accounts/{accountId}/balances"
tags: ["Accounts"]
---

# Get all types of balances for the selected account.

`GET /v1/accounts/{accountId}/balances`

## Request

- Base URL: `https://oas.finshark.io/api.finshark.io`
- URL: `https://oas.finshark.io/api.finshark.io/v1/accounts/{accountId}/balances`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/finshark/apis/finshark-api/docs/v1/accounts/:accountId/balances/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `accountId` string, required

## Headers

- `sessionId` string, uuid
- `authorizationId` string, uuid

## Response `200`

Request was fulfilled and balances are listed.

- BalancesResponse: The object with the account's balances.
  - `accountId` string, nullable: The internal technical identifier of the account.
  - `balances` BalancesDetails: Represents the details of the different types of balances.
    - `available` Amount: Amount with value and currency.
      - `currency` string, nullable: The currency code. This must be a valid ISO 4217 currency code. See the ASPSPs' documentation for details of supported currencies.
      - `value` number, double, nullable: The amount given with fractional digits, where fractions must be compliant to the currency definition. Up to 14 significant figures. Negative amounts are signed by minus. The decimal separator is a dot.: -?[0-9]{1,14}(\\.[0-9]{1,3})?.
    - `booked` Amount: Amount with value and currency.
      - `currency` string, nullable: The currency code. This must be a valid ISO 4217 currency code. See the ASPSPs' documentation for details of supported currencies.
      - `value` number, double, nullable: The amount given with fractional digits, where fractions must be compliant to the currency definition. Up to 14 significant figures. Negative amounts are signed by minus. The decimal separator is a dot.: -?[0-9]{1,14}(\\.[0-9]{1,3})?.
    - `creditLimit` Amount: Amount with value and currency.
      - `currency` string, nullable: The currency code. This must be a valid ISO 4217 currency code. See the ASPSPs' documentation for details of supported currencies.
      - `value` number, double, nullable: The amount given with fractional digits, where fractions must be compliant to the currency definition. Up to 14 significant figures. Negative amounts are signed by minus. The decimal separator is a dot.: -?[0-9]{1,14}(\\.[0-9]{1,3})?.
    - `current` Amount: Amount with value and currency.
      - `currency` string, nullable: The currency code. This must be a valid ISO 4217 currency code. See the ASPSPs' documentation for details of supported currencies.
      - `value` number, double, nullable: The amount given with fractional digits, where fractions must be compliant to the currency definition. Up to 14 significant figures. Negative amounts are signed by minus. The decimal separator is a dot.: -?[0-9]{1,14}(\\.[0-9]{1,3})?.

## Other responses

- `204`: Indicates that the request was performed but no content is returned.
- `206`: Successful response, with a partial representation of a list of transactions.
- `400`: Error caused by invalid or missing data.
- `401`: Authentication failed due to missing or invalid credentials.
- `403`: Error caused by end user (PSU) not permitted access to the resource.
- `404`: Endpoint does not exist or URL is not constructed correctly.
- `429`: Error caused by exceeding unattended accesses to api due to calling to this api and account combination too many times in one day.
- `500`: Error caused by remote technical issues, this status code is used for unforeseen technical issues.
- `503`: Returned when service is unavailable due to scheduled reasons, such as maintenance.
- `504`: Returned when request has been timed out in the gateway.

---

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