---
title: "Retrieve report status"
method: GET
path: "/connectivity-payments/recon-reports/{request-id}"
tags: ["Report status"]
---

# Retrieve report status

`GET /connectivity-payments/recon-reports/{request-id}`

Retrieves the current processing status of a reconciliation report generation request.

Poll this endpoint after calling the [generate report endpoint](#tag/Reconciliation-reports) until `status` is `READY`, `EMPTY`, or `ERROR`. When the report is ready, the response includes a pre-signed `download_url` and a `filename`. The download URL is valid until `download_url_expires_at` (approximately 15 minutes after generation). Download the report before it expires — to get a new download URL after expiry, call the [generate report endpoint](#tag/Reconciliation-reports) again. If `status` is `ERROR` or `EMPTY`, stop polling and submit a new report generation request if needed.

**Connection type**: Reservations connection type is required to access this endpoint.

This endpoint is rate-limited to 10 requests per minute.

## Path parameters

- `request-id` string, required

## Headers

- `Authorization` string, required
- `accept-version` string

## Response `200`

Report status retrieved successfully.

- ReconReportStatusResponse — Response containing the current status of a reconciliation report generation request.
  - `meta` DefaultMeta — Metadata for the response
    - `ruid` string — Request unique identifier
  - `data` ReconReportStatusData — Status and download details for a reconciliation report generation request.
    - `request_id` string — Unique identifier of the report generation request.
    - `status` string — Current status of the report. Possible values: `GENERATING`, `READY`, `EMPTY`, `ERROR`.
    - `updated_at` string, date-time — Timestamp of the most recent status update, in ISO 8601 format.
    - `download_url_expires_at` string, date-time, nullable — Timestamp at which the `download_url` expires, in ISO 8601 format. Only present when `status` is `READY`. Download the report before this time.
    - `filename` string, nullable — Name of the generated report file. Only present when `status` is `READY`.
    - `download_url` string, uri, nullable — Pre-signed URL for downloading the generated report. Only present when `status` is `READY`. This URL is valid for approximately 15 minutes and expires at `download_url_expires_at`. To obtain a new download URL after expiry, call the generate report endpoint again.
  - `errors` unknown[]
    - unknown
  - `warnings` unknown[]
    - unknown

## Other responses

- `400` — Invalid request payload.
- `401` — Unauthorized. Missing or invalid authentication token.
- `403` — Access Denied!
- `404` — The requested report was not found.
- `429` — Too many requests. Rate limiting is enforced.
- `500` — The request failed with an internal server error.

---

[API](https://skmtc.net/booking/apis/reconciliation-api.md) · [All operations](https://skmtc.net/booking/apis/reconciliation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/booking/reconciliation-api/revisions/e3d7945a88fd/schema)