---
title: "Get report"
method: GET
path: "/ledger/v1/reports/{id}"
tags: ["Wallets"]
---

# Get report

`GET /ledger/v1/reports/{id}`

## Request

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

Retrieves a report by its ID, including its current status and a signed URL to download the report file.

Use this endpoint to poll for report completion instead of relying only on the `bvnk:ledger:report:ready` webhook. You get the report ID in the [Generate report](https://docs.bvnk.com/bvnk/api-explorer/endpoints/wallet-transaction-report) response and in the webhook payload.

## Path parameters

- `id` string, uuid, required

## Response `200`

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

## Other responses

- `404`: Not found.

## Changes

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

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/ledger/v1/reports/:id/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)