---
title: "List of account reports"
method: GET
path: "/account-reports"
tags: ["Account Reports"]
---

# List of account reports

`GET /account-reports`

Returns a list of account reports. Account Reports are like interim statements and therefore contains information which may not be definitive but it's the best  information available at the moment the report was generated. This endpoint fetches all reports from all bank accounts enrolled in Shinkansen Treasury and can be identified by the `bank_account_id` field. List can be filtered by date-time ranges. Usually only the latest report is needed (as  it has the most up to date information), so you can filter by `latest` to only get the latest report for each bank account. 
NOTE: In general you should NOT use Account Report information for any information whose booking date is prior to the latest Statement available.

## Response `200`

List of account reports

- AccountReports — List of account reports
  - `account_reports` AccountReport[], required — A list of statements
    - `account_report_id` string, required — UUID Unique identifier for this account report.
    - `currency` string, required — Currency ISO 4217 code (e.g: `"CLP"`)
    - `timestamp` string, date-time, required — The timestamp of the account report.
    - `opening_balances` Balance — An account balance with type
      - `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
    - `closing_balances` Balance, required — An account balance with type
      - `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/versions/1e4a6760b7e8/schema)