---
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`

## Request

- Base URL: `https://api.treasury.shinkansen.finance/v1`
- URL: `https://api.treasury.shinkansen.finance/v1/accounts/{fin_id}/{account}/balances/latest`
- Auth: API key in header `Shinkansen-Treasury-Api-Key`

Returns the latest balance (available balance and book balance) for the given account.

## Response `200`

The `balances` array holds the latest `snapshot` balance for the account, which works in real(ish)-time but can be slightly inaccurate under some situations for some financial institutions. The array is empty when no balance has been captured for the account yet.

- 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: The balances known for the account. It holds a single `snapshot` entry when a balance is available, and is empty when none has been captured yet.
    - `balance_type` 'snapshot' | 'end_of_statement', required: The type of balance. Can be of type: - `snapshot`: the balance of the account at the moment the source was captured. It is the most up-to-date balance available, but it can be slightly inaccurate under some situations for some financial institutions. It is the type returned by `/balances/latest`. - `end_of_statement`: the balance at the boundary of an official statement. It is always accurate, but it can be weeks or a month old. It is the type carried by the `opening_balance` and `closing_balance` of `/statements`.
    - `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.
- `503`: The service could not reach its database to resolve the request. The request was not applied and can be retried.

---

[API](https://skmtc.dev/shinkansen/apis/treasury-shinkansen-endpoints.md) - [All operations](https://skmtc.dev/shinkansen/apis/treasury-shinkansen-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/shinkansen/apis/treasury-shinkansen-endpoints/revisions/2d3ec7684af3?raw)