# List available reports

`GET https://api.cademi.com.br/api/v3/reports`

Operation ID: `reports.list` · API v3

Returns the catalog of available reports, including the filters each report accepts, its columns, and the source and freshness of its data. Columns marked as personal data are returned only when the credentials also have the `users.read_personal` permission.

The catalog is static and contains no account data.

Required permissions: `reports.read`.

## Responses

### 200

Returns the report catalog.

Body: `data`: array of Report.

Fields of Report:

| Field | Type | Required | Description |
|---|---|---|---|
| `columns` | array of object | yes |  |
| `filters` | array of object | yes |  |
| `freshness` | string | yes | Declared freshness of the report data, such as daily. |
| `id` | string | yes |  |
| `object` | string, one of `report` | yes |  |
| `source` | string, one of `metrics`, `live` | yes |  |

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

Full schema: https://cademi.dev/openapi/v3.json