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

# List of account reports

`GET /account_reports`

## Request

- Base URL: `https://api.treasury.shinkansen.finance/v1`
- URL: `https://api.treasury.shinkansen.finance/v1/account_reports`
- Auth: API key in header `Shinkansen-Treasury-Api-Key`

Returns every account report of the bank accounts you own. Account reports are interim statements and therefore contain information which may not be definitive, but it's the best information available at the moment the report was generated.

This endpoint takes no query parameters and returns no pagination: the response holds the full set, ordered by whatever the database returns. It is also the only Treasury index endpoint without filters, so narrowing the result set has to happen on your side.

NOTE: In general you should NOT use account report information for anything whose booking date is prior to the latest statement available.

## Response `200`

List of account reports

- AccountReports: List of account reports
  - `data` AccountReport[], required: The account reports of the bank accounts you own.
    - `id` integer, required: Internal identifier of the report. This is the value to pass to the single-report endpoint.
    - `notification_type` string, required: The type of notification that carried the report.
    - `notification_id` string, required: Identifier of the notification that carried the report.
    - `notification_date` string, date-time, required: When the notification carrying the report was received.
    - `account_report_id` string, required: Identifier of the report as reported by the financial institution.
    - `account_report_date` string, date-time, required: When the financial institution generated the report.
    - `account` string, required: The account number the report belongs to.
    - `financial_institution` object, required: The financial institution where the account is held.
      - `fin_id` string, required: The identifier of the financial institution.
      - `fin_id_schema` string, required: The schema the `fin_id` belongs to.
    - `currency` string, required: Currency ISO 4217 code (e.g: `"CLP"`)
    - `origin` 'internal' | 'external', required: Where the report came from. `internal` for reports Shinkansen obtained from the bank on your behalf, `external` for reports you or a third party delivered to Shinkansen.
    - `balances` object, required: The balances of the account at the moment of the report.
      - `book_balance` string, nullable: The book balance, as an ISO20022-compatible string. It includes movements which haven't been settled yet. `null` when the report did not carry it.
      - `available_balance` string, nullable: The available balance, as an ISO20022-compatible string. It excludes movements which haven't been settled yet. `null` when the report did not carry it.

## Other responses

- `403`: Forbidden (e.g: wrong API Key)

---

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