# Retrieve report status

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

Poll this endpoint after calling the generate report endpoint 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 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.

Endpoint: GET /connectivity-payments/recon-reports/{request-id}
Version: 1.0

## Header parameters:

  - `Authorization` (string, required)
    Bearer token for authentication.
    Example: "Bearer <your_token>"

  - `accept-version` (string)
    API version to use.
    Example: "1.0"

## Path parameters:

  - `request-id` (string, required)
    The unique identifier of the reconciliation report generation request, returned by the generate report endpoint.
    Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"

## Response 200 fields (application/json):

  - `meta` (object)
    Metadata for the response

  - `meta.ruid` (string)
    Request unique identifier
    Example: "string"

  - `data` (object)
    Status and download details for a reconciliation report generation request.

  - `data.request_id` (string)
    Unique identifier of the report generation request.
    Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"

  - `data.status` (string)
    Current status of the report. Possible values: GENERATING, READY, EMPTY, ERROR.
    Example: "READY"

  - `data.updated_at` (string)
    Timestamp of the most recent status update, in ISO 8601 format.
    Example: "2026-06-10T08:50:48Z"

  - `data.download_url_expires_at` (string,null)
    Timestamp at which the download_url expires, in ISO 8601 format. Only present when status is READY. Download the report before this time.
    Example: "2026-06-11T08:50:48Z"

  - `data.filename` (string,null)
    Name of the generated report file. Only present when status is READY.
    Example: "reconciliation-report.csv"

  - `data.download_url` (string,null)
    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.
    Example: "https://example.com/path"

  - `errors` (array)

  - `warnings` (array)

## Response 400 fields (application/json):

  - `meta` (object)
    Metadata for the response

  - `meta.ruid` (string)
    Request unique identifier
    Example: "string"

  - `data` (object)
    Data containing required information

  - `errors` (array)
    List of errors for the response

  - `errors.description` (string)
    Description of the error

  - `errors.message` (string)
    Error message

  - `errors.status_code` (integer)
    HTTP status code for the error

  - `errors.debug_message` (string)
    Detailed debug message for the error

  - `warnings` (array)
    List of warnings for the response

  - `warnings.message` (string)
    Warning message
    Example: "string"

## Response 401 fields (application/json):

  - `meta` (object)
    Metadata for the response

  - `meta.ruid` (string)
    Request unique identifier
    Example: "string"

  - `warnings` (array)
    List of warnings for the response

  - `errors` (array)
    List of errors for the response

  - `errors.message` (string)
    Error message

  - `errors.code` (string)
    Error code

  - `errors.details` (string,null)
    Additional error details

## Response 403 fields (application/json):

  - `meta` (object)
    Metadata for the response

  - `meta.ruid` (string)
    Request unique identifier
    Example: "string"

  - `data` (object)
    Data containing required information

  - `errors` (array)
    List of errors for the response

  - `warnings` (array)
    List of warnings for the response

## Response 404 fields (application/json):

  - `meta` (object)
    Metadata for the response

  - `meta.ruid` (string)
    Request unique identifier
    Example: "string"

  - `data` (object)
    Data containing required information

  - `errors` (array)
    List of errors for the response

  - `warnings` (array)
    List of warnings for the response

## Response 429 fields (application/json):

  - `meta` (object)
    Metadata for the response

  - `meta.ruid` (string)
    Request unique identifier
    Example: "string"

  - `data` (object)
    Data containing required information

  - `errors` (array)
    List of errors for the response

  - `warnings` (array)
    List of warnings for the response

## Response 500 fields (application/json):

  - `meta` (object)
    Metadata for the response

  - `meta.ruid` (string)
    Request unique identifier
    Example: "string"

  - `data` (object)
    Data containing required information

  - `errors` (array)
    List of errors for the response

  - `warnings` (array)
    List of warnings for the response