---
title: "Get external account balances"
method: GET
path: "/external_accounts/{external_account_id}/balance"
tags: ["External Accounts"]
---

# Get external account balances

`GET /external_accounts/{external_account_id}/balance`

Given an external account ID, return the account balances in real time.

The data returned by this endpoint is always fetched synchronously; it is not cached by Synctera.
As a result, response latency is often high.

## Path parameters

- `external_account_id` string, uuid, required

## Query parameters

- `max_age` integer

## Response `200`

A collection of fields that represent funds available in the account. The
relationship between these fields is complex and can depend on geography and/or
the external financial institution. You should not assume that all of these fields
will be set, and you should not expect consistent results for different customers
at different financial institutions.

If you use Plaid as your backing vendor, see https://plaid.com/docs/api/products/balance/
for precise details on when these fields are set and how they relate.

- ExternalAccountBalance
  - `available` integer, nullable — The amount of funds available to be withdrawn from the account, as determined by the financial institution. This is an integer in the minor currency unit (e.g. cents): 1025 means $10.25.
  - `creation_time` string, date-time
  - `currency` string, required — ISO 4217 alphabetic currency code
  - `current` integer, nullable — For a `DEPOSITORY` account, this is the total amount of funds in the account. For a `CREDIT` account, this is the amount owing. If negative, the lender owes the account holder. This is an integer in the minor currency unit (e.g. cents): -2500 means $25.00 owed to the account holder.
  - `last_updated_time` string, date-time — The last time Synctera has fetched this balance from a vendor
  - `last_updated_time_vendor` string, date-time — Vendor timestamp of when the balance was last updated on the vendor side
  - `limit` integer, nullable — For `DEPOSITORY` accounts, this is the pre-arranged overdraft limit, commonly used in Europe. In North America this is typically not set for depository accounts. For `CREDIT` accounts, this is the credit limit on the account. This is an integer in the minor currency unit (e.g. cents): 10000 means $100.00
  - `transactions_last_updated_time` string, date-time — The last time Synctera has fetched transactions from a vendor

## Other responses

- `401` — Unauthorized
- `403` — Forbidden error
- `404` — Resource not found
- `500` — Internal server error

---

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