# List Reports

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

Your tenant's reports, newest first.

## Overview

- `status` narrows it: `queued`, `running`, `ready`, `failed` or `expired`. Up to `limit` (1–100, default 20) in `reports`, and `nextCursor` to send as `cursor` for the next page — `null` on the last.
- Each report as [Get a Report](https://docs.aureahub.com/docs/report-get.md) answers it: a ready one with a new download link.
- The same roles as [Ask for a Report](https://docs.aureahub.com/docs/report-request.md), on their own tenant ([Reports](https://docs.aureahub.com/docs/guide-reports.md)).

## Endpoint

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

Authentication: bearer token required.

The tenant's reports, newest first.

**Path parameters**

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

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `status` | string | no | `queued`, `running`, `ready`, `failed` or `expired` |
| `cursor` | string (uuid) | no | The previous page's `nextCursor` |
| `limit` | integer | no | 1–100, default 20 |

**Responses**

`200` OK

```json
{
  "reports": [
    {
      "id": "4c8e2a19-7d3b-4f60-9a1e-5b2d8c6f0e73",
      "type": "movements",
      "format": "csv",
      "status": "failed",
      "failureCode": "REPORT_TOO_LARGE",
      "…": "the report, as Get a Report answers it"
    }
  ],
  "nextCursor": null
}
```

---

Web version: https://docs.aureahub.com/#reports-list