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

# Retrieve report run details

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`.

## 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.
    Possible enum values:

    - `processing`
    - `completed`
    - `failed`
    - `expired`
- `file_url` (string, optional)
    Use this link to download report file. Not available, until `status` is `completed`.

## Error responses

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