v1

latestOpenAPI 3.0.0Proprietary2026-07-2642128296.2 KB
Balances

Returns the latest balances for the account

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)

get/accounts/{fin_id}/{account}/balances/latest

Response

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).

accountstring required

Account number

currencystring required

Currency ISO 4217 code (e.g: "CLP")

Example response

{
  "account": 123456789012,
  "financial_institution": {
    "fin_id_schema": "SHINKANSEN",
    "fin_id": "BANCO_BICE_CL"
  },
  "currency": "CLP",
  "balances": [
    {
      "balance_type": "snapshot",
      "book_balance": 123.5,
      "available_balance": 123.5,
      "timestamp": "2019-06-04T00:00:00.000Z",
      "source": {
        "source_type": "account_report",
        "source_id": "ab1def2g-7e98-4e13-8b03-0b3b2e6d5a3c"
      }
    },
    {
      "balance_type": "end_of_booking_day",
      "book_balance": 123.5,
      "available_balance": 123.5,
      "date": "2019-06-03",
      "timestamp": "2019-06-03T18:05:00.000Z",
      "source": {
        "source_type": "account_report",
        "source_id": "ab1def2g-7e98-4e13-8b03-0b3b2e6d5a3c"
      }
    },
    {
      "balance_type": "end_of_statement",
      "book_balance": 123.5,
      "available_balance": 123.5,
      "date": "2019-05-30",
      "timestamp": "2019-06-01T18:00:00.000Z",
      "source": {
        "source_type": "account_statement",
        "source_id": "bff1ecf0-7e98-4e13-8b03-0b3b2e6d5a3c"
      }
    }
  ]
}