---
title: "Get an account balance"
method: GET
path: "/accounts/{accountId}/balance"
tags: ["Accounts"]
---

# Get an account balance

`GET /accounts/{accountId}/balance`

The `GET /accounts/{accountId}/balance` endpoint retrieves the balance for a given bank account.

## Path parameters

- `accountId` string

## Headers

- `on-behalf-of` string, required
- `token-customer-ip-address` string, ipv4

## Response `200`

Successful response

- GetBalanceResponse
  - `balance` Balance — Relevant information associated with the monetary balance of an individual account.
    - `accountId` string — The unique identifier for the account.
    - `available` object — The balance currency and value.
      - `currency` string, required — The <a href="https://www.iso.org/iso-4217-currency-codes.html" target="_blank">ISO 4217</a> three letter currency code.
      - `value` string, required — The transaction amount with up to four digits after the decimal point.
    - `current` object — The balance currency and value.
      - `currency` string, required — The <a href="https://www.iso.org/iso-4217-currency-codes.html" target="_blank">ISO 4217</a> three letter currency code.
      - `value` string, required — The transaction amount with up to four digits after the decimal point.
    - `otherBalances` BalanceTypedBalance[] — Other bank-defined balances associated with the account, where applicable.
      - `amount` object — The balance currency and value.
        - `currency` string, required — The <a href="https://www.iso.org/iso-4217-currency-codes.html" target="_blank">ISO 4217</a> three letter currency code.
        - `value` string, required — The transaction amount with up to four digits after the decimal point.
      - `type` string — A bank-defined type of other balance.
      - `updatedAtMs` string, string — The last update timestamp in milliseconds, 1 day (24 hours) = 8640000000, 1 hour = 36000000, and 1 minute = 60000
  - `status` 'INVALID_REQUEST' | 'SUCCESSFUL_REQUEST' | 'MORE_SIGNATURES_NEEDED' — Specifies the status of the request.

## Other responses

- `400` — The client specified an invalid argument
- `401` — The authorization information is missing or invalid
- `403` — Permission to access this endpoint is denied
- `404` — The requested entity, such as a payment, was not found
- `429` — Too many requests
- `500` — An unexpected or internal server error
- `501` — The operation was not implemented
- `503` — Service is unavailable
- `504` — Gateway has timed out

---

[API](https://skmtc.net/token/apis/token-io-s-open-banking-api-for-tpps.md) · [All operations](https://skmtc.net/token/apis/token-io-s-open-banking-api-for-tpps/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/token/token-io-s-open-banking-api-for-tpps/versions/5e8d6d2c24a1/schema)