---
api: 'Merchant API'
---

# Retrieve a report run

Retrieve details of a report run, based on the `report_run_id`. 

Use this method to check the status of a report run.

If a report run's `status` is `completed`, the report file can be downloaded using the `file_url` for 24 hours after report generation finishes.

Once that 24-hour window elapses, the report run remains retrievable but transitions to `expired`, and the file can no longer be downloaded.

## Endpoint

GET `/api/report-runs/{report_run_id}`

## Returns

### 200

Report run found

#### Response attributes

- `report_run_id` (string)
    Unique ID used for accessing report details. Use this to check report generation status.
- `status` (enum)
    Current status of the report run.
    
    | Value | Description |
    | ----- | ----------- |
    | `processing` | Report generation is still in progress. |
    | `completed` | Report generation finished successfully and the file is available to download for 24 hours via `file_url`. |
    | `failed` | Report generation failed and no report file is available. |
    | `expired` | Report generation previously completed, but the 24-hour file availability window has elapsed and the file can no longer be downloaded. |
    Possible enum values:

    - `processing`
    - `completed`
    - `failed`
    - `expired`
- `file_url` (string, optional)
    Use this link to download the report file. Available only when `status` is `completed`, and only for 24 hours after report generation finishes.

## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad Request |
| 401 | Unauthorized |
| 404 | Not Found |