# ListReports

## Description

The `ListReports` operation returns the list of report files currently available
for the account on the target marketplace. Each entry carries the filename, MD5,
size and last-modified timestamp; the report contents are downloaded separately
via [GetReport](en-us/api-reference/operations/get-report).

Reports live on the `/reports/v1` path, distinct from the catalog operations
(`/catalog/v1`). Report access depends on the credential/account permissions and
does not necessarily coincide with feed access.

## Availability

Depends on marketplace, account permissions and date. A family absent from the
response may simply be unavailable for the selected account or date range — never
infer it is unsupported.

## Request

`POST /reports/v1/listReports`

No request body. Only the common headers are required (see
[Common Request Headers and Parameters](en-us/concepts/common-request-headers-and-parameters)),
in particular `x-marketplace` and the OAuth2 `Authorization` bearer token.

## Response

| Field | Description |
| :--- | :--- |
| reports | List of report metadata objects. |
| reports[].filename | Report file name, form `<account>-<family>-<YYYYMMDD>.tsv.gz`. |
| reports[].md5 | MD5 of the report body. |
| reports[].size | Size in bytes. |
| reports[].lastModified | Last-modified timestamp (ISO-8601). |

Example:

```json
{
  "reports": [
    {
      "filename": "acme-tracking_id-report-20260730.tsv.gz",
      "md5": "d41d8cd98f00b204e9800998ecf8427e",
      "size": 1048576,
      "lastModified": "2026-07-30T03:00:00Z"
    }
  ]
}
```

The report families and their TSV schemas are documented in
[Report families](en-us/api-reference/operations/report-families).

## PHP usage

```php
$reports = $client->listReports()['reports'];

// Metadati normalizzati (famiglia + data derivate dal nome file):
use App\CreatorsApi\Model\ReportMetadata;

foreach (ReportMetadata::fromListResponse($client->listReports()) as $report) {
    echo $report->family() . ' @ ' . $report->reportDate() . PHP_EOL;
}
```
