# Get a Report

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

A report's status and, once it is ready, a new signed link to its file.

## Overview

- `status`: `queued` → `running` → `ready`, or `failed` with `failureCode` (`REPORT_TOO_LARGE`, `REPORT_GENERATION_FAILED`); `ready` → `expired` once its file was deleted — 24 hours after it was made, by default (`expiresAt`).
- Ready: `rowCount`, `byteSize`, `sha256` (the file's, hex), `startedAt`, `finishedAt`, `downloads`, and `download` — `url`, a path on this API with its signature, and `expiresAt`, five minutes on. The link works on its own, for whoever holds it: [Download a Report](https://docs.aureahub.com/docs/report-download.md). Each read gives a new link; `download` is `null` otherwise.
- `404` `REPORT_NOT_FOUND` (`Report not found`) for none of your tenant's. The same roles as [Ask for a Report](https://docs.aureahub.com/docs/report-request.md).

## Endpoint

### `GET /v1/admin/tenants/{id}/reports/{reportId}`

Authentication: bearer token required.

A report's status, with a signed download link while it is ready.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string (uuid) | yes | Your tenant's id |
| `reportId` | string (uuid) | yes | The report's id |

**Responses**

`200` Ready

```json
{
  "id": "4c8e2a19-7d3b-4f60-9a1e-5b2d8c6f0e73",
  "type": "movements",
  "format": "csv",
  "filters": { "from": "2026-10-01T00:00:00.000Z", "to": "2026-10-13T00:00:00.000Z", "chains": ["base"] },
  "status": "ready",
  "failureCode": null,
  "rowCount": 1842,
  "byteSize": 412907,
  "sha256": "9f2c7a1e4b8d3f6a0c5e2b9d7f1a4c8e6b3d0f2a5c7e9b1d4f6a8c0e2b5d7f9a",
  "requestedBy": "6a1c9e3f-2b7d-4f50-8e4a-0c5d3b9f7e12",
  "createdAt": "2026-10-13T11:00:00.000Z",
  "startedAt": "2026-10-13T11:00:20.114Z",
  "finishedAt": "2026-10-13T11:00:23.871Z",
  "expiresAt": "2026-10-14T11:00:23.871Z",
  "downloads": 0,
  "download": {
    "url": "/v1/admin/tenants/6f1e2d3c-4b5a-4968-8776-a5b4c3d2e1f0/reports/4c8e2a19-7d3b-4f60-9a1e-5b2d8c6f0e73/download?expires=1791889524&signature=NOc0nc5n6BWdO37fjGvCQydAPzcx4Qnc0To0AOI_EQI",
    "expiresAt": "2026-10-13T11:05:24.000Z"
  }
}
```

`404` Not found

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "Report not found",
  "details": { "code": "REPORT_NOT_FOUND" }
}
```

**Example request**

```bash
curl https://api.aureahub.com/v1/admin/tenants/$TENANT_ID/reports/4c8e2a19-7d3b-4f60-9a1e-5b2d8c6f0e73 \
  -H "Authorization: Bearer $TENANT_ADMIN_TOKEN"
```

---

Web version: https://docs.aureahub.com/#report-get