---
title: "List reports"
method: GET
path: "/ledger/v1/reports"
tags: ["Wallets"]
---

# List reports

`GET /ledger/v1/reports`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/ledger/v1/reports`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/ledger/v1/reports/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the reports generated for your account, including the current status of each report.

Use this endpoint together with [Get report](https://docs.bvnk.com/bvnk/api-explorer/endpoints/get-report) to poll for report completion instead of relying only on the `bvnk:ledger:report:ready` webhook.

## Response `200`

Reports retrieved successfully

- object[]
  - `id` integer: The ID of the transaction request.
  - `uuid` string: The UUID of the transaction report.
  - `dateCreated` integer: The date and time, encoded into UNIX epoch timestamps.
  - `lastUpdated` integer: The date and time, encoded into UNIX epoch timestamps.
  - `expiryDate` integer: The date and time, encoded into UNIX epoch timestamps.
  - `status` string: The status of the transaction report. A report normally moves through `PENDING`, `PROCESSING`, `READY`, and `SENT`. - `PENDING`: The report request is queued. - `PROCESSING`: The report is being generated. - `READY`: The report is generated and ready for download. - `SENT`: The report has been delivered through the requested delivery channel. - `FAILED`: The report could not be generated. - `FALLBACK`: The requested period is before 2023-12-01, so the request is handled by the legacy report.
  - `type` string: The type of the report.
  - `requestData` TransactionReportRequestDataDto
    - `type` string: The type of report.
    - `externalProcessing` string
    - `walletId` string, int64: The wallet ID For the report.
    - `transactionType` string: The transaction type.
    - `fromDate` string: The from date of the report.
    - `toDate` string: The to date of the report.
    - `format` string: The format of the report.
    - `languageTag` string: The language tag of the report.
    - `category` integer: The category of the report.
    - `accountName` string: The account name.
    - `include` string
    - `exclude` string
  - `url` string, uri: Signed URL to download the report file. Returned once the report is available.

## Changes

- **2026-11-06** `c386d436bf2c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/ledger/v1/reports/get.md)

---

[API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [All operations](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/revisions/c386d436bf2c?raw)