---
title: "List reports"
method: GET
path: "/reports"
tags: ["Reports (Beta)"]
---

# List reports

`GET /reports`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/reports`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/reports/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of report jobs scoped to the calling tenant.

**Note:** Download URLs are not included in list responses. Call `GET /v1/reports/{reportId}` to
obtain a fresh signed download URL for a specific completed report.

**Note:** These endpoints are currently in beta and might be subject to changes.

Endpoint Permission: Viewer and above.

## Query parameters

- `pageCursor` string
- `pageSize` integer
- `sortBy` 'createdAt' | 'completedAt'
- `order` 'ASC' | 'DESC'
- `status` ReportStatus[]
- `reportType` ReportType[]

## Response `200`

Paginated list of report jobs

- ReportListResponse: Paginated list of report jobs. Download URLs are not included in list items — call `GET /v1/reports/{reportId}` to retrieve the download URL for a specific completed report.
  - `data` ReportJob[], required: Page of report jobs
    - `id` string, required: Unique identifier of the report job
    - `status` 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED', required: The current lifecycle state of a report job
    - `reportType` 'ADDRESSES', required: The type of report to generate
    - `outputFormat` 'CSV', required: The output file format of the report
    - `compress` boolean, required: Whether the output file is gzip-compressed
    - `requestedByUserId` string, required: ID of the user who requested the report
    - `createdAt` integer, required: Epoch milliseconds (UTC) when the job was created
    - `completedAt` integer: Epoch milliseconds (UTC) when the report completed. Only present when `status` is `COMPLETED`.
    - `failedAt` integer: Epoch milliseconds (UTC) when the report failed. Only present when `status` is `FAILED`.
    - `rowCount` integer: Number of rows in the report file. Only present when `status` is `COMPLETED`.
    - `fileSizeBytes` integer: Size of the report file in bytes (includes compression when `compress` is `true`). Only present when `status` is `COMPLETED`.
  - `next` string, nullable, required: Opaque cursor for the next page. Null on the last page.
  - `prev` string, nullable, required: Opaque cursor for the previous page. Null on the first page.

## Other responses

- `default`: Error Response

---

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