# GetReport

## Description

The `GetReport` operation returns a short-lived presigned URL from which the
report file (a gzip-compressed TSV, `.tsv.gz`) can be downloaded. The filename is
obtained from [ListReports](en-us/api-reference/operations/list-reports).

## Availability

Same as [ListReports](en-us/api-reference/operations/list-reports): depends on
marketplace and account permissions.

## Request

`POST /reports/v1/getReport`

| Name | Description | Required |
| :--- | :--- | :--- |
| filename | The report file name as returned by `ListReports`. <ul><li>Type: <i>String (Non-Empty)</i></li><li>Usage: <code>{"filename":"acme-tracking_id-report-20260730.tsv.gz"}</code></li></ul> | Yes |

## Response

| Field | Description |
| :--- | :--- |
| url | Presigned URL to download the `.tsv.gz` report body. |

Example:

```json
{
  "url": "https://creatorsapi-reports.example/acme-tracking_id-report-20260730.tsv.gz?X-Amz-Signature=..."
}
```

The Amazon TSV file carries a title on row 1 and column headings on row 2. The
report date is derived from the `YYYYMMDD` suffix of the filename.

## PHP usage

```php
$url = $client->getReport('acme-tracking_id-report-20260730.tsv.gz')['url'];

$gz = file_get_contents($url);
$tsv = gzdecode($gz);
```
