---
title: "Get Account Balances"
method: GET
path: "/data/v2/accounts/{id}/balances"
tags: ["Data v2.Account", "BETA", "REGION.US"]
---

# Get Account Balances

`GET /data/v2/accounts/{id}/balances`

Signage on balances:
The balance amount signage is either positive or negative - 
1. A balance that is `positive` indicates there are funds available to be spent.
2. A balance that is `negative` indicates that the user owes funds to the financial institution.
The above is true for both depository accounts and credit accounts.

## Path parameters

- `id` string, required

## Response `200`

Successful.

- AccountsV2Balances
  - `accountId` string — The internal identifier of account.
  - `balances` AccountsV2BalanceDetails
    - `availableBalanceExcludingCredit` AccountsV2Balance
      - `amount` BalancesV2CurrencyDenominatedAmount, required
        - `currencyCode` string, required — The ISO 4217 currency code of the amount
        - `value` AccountsV2DenominatedAmount, required
          - `scale` integer, required — The scale of the amount. <br/>The `unscaledValue` is used with `scale` to accurately represent floating point values. <br/>The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
          - `unscaledValue` integer, required — The unscaled value of the amount. <br/>The `unscaledValue` is used with `scale` to accurately represent floating point values. <br/>The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
        - `valueInMinorUnit` integer, required — The valueInMinorUnit field represents the amount of the balance in the smallest unit of the specified currency. This value ensures precision by avoiding floating-point arithmetic errors. For instance, in the case of USD (United States Dollar), where 1 USD equals 100 cents, a balance of $10.50 would be represented as 1050 in the valueInMinorUnit field.
    - `availableBalanceIncludingCredit` AccountsV2Balance
      - `amount` BalancesV2CurrencyDenominatedAmount, required
        - `currencyCode` string, required — The ISO 4217 currency code of the amount
        - `value` AccountsV2DenominatedAmount, required
          - `scale` integer, required — The scale of the amount. <br/>The `unscaledValue` is used with `scale` to accurately represent floating point values. <br/>The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
          - `unscaledValue` integer, required — The unscaled value of the amount. <br/>The `unscaledValue` is used with `scale` to accurately represent floating point values. <br/>The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
        - `valueInMinorUnit` integer, required — The valueInMinorUnit field represents the amount of the balance in the smallest unit of the specified currency. This value ensures precision by avoiding floating-point arithmetic errors. For instance, in the case of USD (United States Dollar), where 1 USD equals 100 cents, a balance of $10.50 would be represented as 1050 in the valueInMinorUnit field.
    - `bookedBalance` AccountsV2Balance
      - `amount` BalancesV2CurrencyDenominatedAmount, required
        - `currencyCode` string, required — The ISO 4217 currency code of the amount
        - `value` AccountsV2DenominatedAmount, required
          - `scale` integer, required — The scale of the amount. <br/>The `unscaledValue` is used with `scale` to accurately represent floating point values. <br/>The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
          - `unscaledValue` integer, required — The unscaled value of the amount. <br/>The `unscaledValue` is used with `scale` to accurately represent floating point values. <br/>The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
        - `valueInMinorUnit` integer, required — The valueInMinorUnit field represents the amount of the balance in the smallest unit of the specified currency. This value ensures precision by avoiding floating-point arithmetic errors. For instance, in the case of USD (United States Dollar), where 1 USD equals 100 cents, a balance of $10.50 would be represented as 1050 in the valueInMinorUnit field.
  - `creditLimit` AccountsV2Balance
    - `amount` BalancesV2CurrencyDenominatedAmount, required
      - `currencyCode` string, required — The ISO 4217 currency code of the amount
      - `value` AccountsV2DenominatedAmount, required
        - `scale` integer, required — The scale of the amount. <br/>The `unscaledValue` is used with `scale` to accurately represent floating point values. <br/>The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
        - `unscaledValue` integer, required — The unscaled value of the amount. <br/>The `unscaledValue` is used with `scale` to accurately represent floating point values. <br/>The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
      - `valueInMinorUnit` integer, required — The valueInMinorUnit field represents the amount of the balance in the smallest unit of the specified currency. This value ensures precision by avoiding floating-point arithmetic errors. For instance, in the case of USD (United States Dollar), where 1 USD equals 100 cents, a balance of $10.50 would be represented as 1050 in the valueInMinorUnit field.
  - `refreshed` string, date-time — Last refreshed time of this account, ISO 8601 date and time format in UTC (YYYY-MM-DDThh:mm:ssZ).

## Other responses

- `400` — Incorrect request parameters or user data missing.

---

[API](https://skmtc.net/tink/apis/tink-api.md) · [All operations](https://skmtc.net/tink/apis/tink-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tink/tink-api/revisions/23d8982b533d/schema)