---
title: "Generate a reconciliation report"
method: POST
path: "/connectivity-payments/recon-reports"
tags: ["Reconciliation reports"]
---

# Generate a reconciliation report

`POST /connectivity-payments/recon-reports`

Initiates the asynchronous generation of a financial reconciliation report for one or more properties within a specified date range.

The report is generated asynchronously. The response returns a `request_id` that you use to poll the [report status endpoint](#tag/Report-status) until the `status` is `READY`, `EMPTY`, or `ERROR`. When ready, a pre-signed `download_url` and `filename` are returned for downloading the report. The `download_url` is valid for approximately 15 minutes (see `download_url_expires_at`). To obtain a new download URL after expiry, call this endpoint again to generate a new report. If `status` is `EMPTY` or `ERROR`, stop polling; no report is available for download.

Use the [report filters endpoint](#tag/Report-filters) to retrieve the available `report_configurations` and `report_filters` values before generating a report.

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

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

## Headers

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

## Request body

- ReconReportRequest — Request body for generating a reconciliation report.
  - `properties` PropertySelection[], required — List of legal entities and their associated property IDs to include in the report.
    - `legal_entity_id` string, required — The legal entity identifier.
    - `property_ids` string[], required — List of property IDs belonging to the legal entity to include in the report.
  - `from_date` string, date, required — Start date of the reporting period (inclusive), in `YYYY-MM-DD` format.
  - `to_date` string, date, required — End date of the reporting period (inclusive), in `YYYY-MM-DD` format.
  - `report_configurations` ReportConfigurationInput[] — Optional list of report configuration options, such as output format and locale. Use the [report filters endpoint](#tag/Report-filters) to retrieve available options.
    - `config_key` string, required — The configuration key. Possible values: `format_type`, `locale`.
    - `config_value` string, required — The selected configuration value for the given `config_key`. For example, `CSV`, `XLS`, or `JSON` for `format_type`.
  - `report_filters` ReportFilterInput[] — Optional list of filters to narrow down the report data, such as specific bank accounts or payout types. Use the [report filters endpoint](#tag/Report-filters) to retrieve available options.
    - `filter_key` string, required — The filter key. Possible values: `bank_accounts`, `payout_type`, `statement_descriptor`.
    - `filter_values` string[], required — The selected filter values for the given `filter_key`.

## Response `202`

Report generation request accepted. Use the returned `request_id` with the report status endpoint to check progress and retrieve the download URL.

- ReconReportGenerationResponse — Response returned when a reconciliation report generation request is accepted.
  - `meta` DefaultMeta — Metadata for the response
    - `ruid` string — Request unique identifier
  - `data` ReconReportGenerationData — Data returned when a reconciliation report generation request is accepted.
    - `request_id` string — Unique identifier for the report generation request. Use this value to poll the report status endpoint.
    - `report_status` string — Current status of the report generation. Possible values: `GENERATING`.
  - `errors` unknown[]
    - unknown
  - `warnings` unknown[]
    - unknown

## Other responses

- `400` — Invalid request payload.
- `401` — Unauthorized. Missing or invalid authentication token.
- `403` — Access Denied!
- `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)