# Retrieve a scheduled report run

**GET** `/scheduled-report-runs/{runId}`

Base URL: `https://api.uat.triple-a.io/api/fiat-payout/v1`

This endpoint allows you to retrieve one of your scheduled report runs.

## Authorization

- oauth2 (http, bearer)

## Path parameters

- `runId` (string, required)

## Responses

### 200

OK

- `id` (string<uuid>, required)
- `report_type` ("fp_account_statement", required)
- `frequency` ("daily" | "monthly", required)
- `period_start` (string<date-time>, required)
  Inclusive start of the reporting period (half-open interval `[period_start, period_end)`).
- `period_end` (string<date-time>, required)
  Exclusive end of the reporting period (half-open interval `[period_start, period_end)`).
- `files` (object[], required)
  Generated files, each with its download `access_url`. Null until the run has completed.
  - `id` (string<uuid>, required)
  - `type` (string, required)
  - `access_url` (string<uri>, required)
    URL to fetch the file (see the download endpoint).
- `status` ("pending" | "processing" | "error" | "completed", required)
- `created_at` (string<date-time>, required)
- `updated_at` (string<date-time>, required)

Example:

```json
{
  "id": "00000000-0000-0000-0000-000000000000",
  "report_type": {},
  "frequency": {},
  "period_start": "1970-01-01T00:00:00.000Z",
  "period_end": "1970-01-01T00:00:00.000Z",
  "files": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "type": "string",
      "access_url": "string"
    }
  ],
  "status": {},
  "created_at": "1970-01-01T00:00:00.000Z",
  "updated_at": "1970-01-01T00:00:00.000Z"
}
```

### 400

Error defines errors may be returned from the system.

- `message` (string)
- `errors` (object[])
  - `errorCode` (string)
  - `message` (string)

Example:

```json
{
  "message": "string",
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ]
}
```

### 404

Error defines errors may be returned from the system.

- `message` (string)
- `errors` (object[])
  - `errorCode` (string)
  - `message` (string)

Example:

```json
{
  "message": "string",
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ]
}
```

### 500

Error defines errors may be returned from the system.

- `message` (string)
- `errors` (object[])
  - `errorCode` (string)
  - `message` (string)

Example:

```json
{
  "message": "string",
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ]
}
```