---
title: "Returns the latest balances for the account"
method: GET
path: "/accounts/{fin_id}/{account}/balances/latest"
tags: ["Balances"]
---

# Returns the latest balances for the account

`GET /accounts/{fin_id}/{account}/balances/latest`

Returns the balances (available balance and book balance) for the given account. Balances can have many types depending on the source we use to determine the balance (see the response documention for more details)

## Response `200`

Balances can have many types depending on the source we use to determine the balance. For example, the `snapshot` balance works in real(ish)-time, but can be slightly innacurate under some situations for some financial institutions. At the other end of the spectrum, the `statement` balance is the always accurate, but might be weeks or a month old. The `end_of_booking_day` balance is a compromise between the two: it's extremely unlikely to ever change and will at most be a few of days old (depending on the latest banking day).

- AccountBalances — A list of account balances
  - `account` string, required — Account number
  - `financial_institution` FinancialInstitutionId, required — The identifier for a financial institution
    - `fin_id_schema` string, required — Identification schema for financial institution, namely, any participant in Shinkansen Network. Use `"SHINKANSEN"` for Shinkansen's native network ids and full support on any participant and service of the Shinkansen network. Other schemas might be used when interfacing with other networks but they are *not* recommended unless you *really* know what you are doing or have been explicitly instructed to do so by Shinkansen.
    - `fin_id` string, required — Identification according to schema. When the `"SHINKANSEN"` schema is used (as recommended), this is the ID assigned by Shinkansen to the participant in the network. In the context of the `header`, it refers to the Shinkansen network participant that sends (Sender) or receives (Receiver) the message. In the context of the `transactions`, it refers to the financial institution from which the resources leave or where the resources arrive. The ID assigned by Shinkansen to the financial institution can be found in https://docs.shinkansen.tech/docs/instituciones-financieras. When sending a transaction to Shinkansen, this value must always be SHINKANSEN. When sending a payout order to Shinkansen Treasury, this value must be SHINKANSEN_TREASURY
  - `currency` string, required — Currency ISO 4217 code (e.g: `"CLP"`)
  - `balances` Balance[], required — A list of balances
    - `balance_type` 'snapshot' | 'end_of_booking_day' | 'end_of_statement', required — The type of balance. Can be of type: - `snapshot`: A snapshot of the account at a given time. It's usually the most up-to-date balance, but it can be slightly innacurate under some situations for some financial institutions. - `end_of_booking_day`: It's the balance at the end of a banking day. It's extremely unlikely to ever change and will at most be a few days old (depending on the latest banking day). - `end_of_statement`: It's the balance at the end of an official statement. It's always accurate, but it might be weeks or a month old.
    - `book_balance` string, required — Amount, ISO20022-compatible: Up to 18 integer digits, optional decimal separator ".", up to 5 fraction digits (also optional). By using a string we avoid issues with floating-point arithmetic as well as integer type limits on some JSON implementations.
    - `available_balance` string — Amount, ISO20022-compatible: Up to 18 integer digits, optional decimal separator ".", up to 5 fraction digits (also optional). By using a string we avoid issues with floating-point arithmetic as well as integer type limits on some JSON implementations.
    - `timestamp` string, date-time, required — The timestamp of the balance
    - `source` object, required — The source of the balance
      - `source_type` 'account_report' | 'account_statement', required — The type of source. Can be one of: - `account_report`: The balance was obtained from an account report, which is a real-time but not-yet-official information obtained from a bank. - `account_statement`: The balance was obtained from an official account statement.
      - `source_id` string, required — The id of the source

## Other responses

- `403` — Forbidden (e.g: wrong API Key)
- `404` — Account not found.

---

[API](https://skmtc.net/shinkansen/apis/payouts-shinkansen-endpoints.md) · [All operations](https://skmtc.net/shinkansen/apis/payouts-shinkansen-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shinkansen/payouts-shinkansen-endpoints/revisions/1e4a6760b7e8/schema)