Generate a reconciliation report

Request

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

Authorizationstringrequired

Bearer token for authentication.

Example:Bearer <your_token>

accept-versionstring

API version to use.

Default:"1.0"

Example:1.0

Bodyapplication/jsonrequired

Parameters for the reconciliation report to generate, including target properties, date range, output format, and optional filters.

propertiesArray of objects(PropertySelection)required

List of legal entities and their associated property IDs to include in the report.

from_datestring, (date)required

Start date of the reporting period (inclusive), in YYYY-MM-DD format.

Example:"2025-04-01"

to_datestring, (date)required

End date of the reporting period (inclusive), in YYYY-MM-DD format.

Example:"2025-08-01"

report_configurationsArray of objects(ReportConfigurationInput)

Optional list of report configuration options, such as output format and locale. Use the report filters endpoint to retrieve available options.

report_filtersArray of objects(ReportFilterInput)

Optional list of filters to narrow down the report data, such as specific bank accounts or payout types. Use the report filters endpoint to retrieve available options.

curl -i -X POST \
  https://developers.booking.com/_mock/connectivity/docs/openapispecs/reconciliation-api/reconciliation-api-specification/connectivity-payments/recon-reports \
  -H 'Authorization: Bearer <your_token>' \
  -H 'Content-Type: application/json' \
  -H 'accept-version: 1.0' \
  -d '{
    "properties": [
      {
        "legal_entity_id": "1234567",
        "property_ids": [
          "123456"
        ]
      }
    ],
    "from_date": "2025-04-01",
    "to_date": "2025-08-01",
    "report_configurations": [
      {
        "config_key": "format_type",
        "config_value": "CSV"
      }
    ],
    "report_filters": [
      {
        "filter_key": "bank_accounts",
        "filter_values": [
          "DE123456789"
        ]
      }
    ]
  }'

Responses

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

Bodyapplication/json

metaobject(DefaultMeta)

Metadata for the response

dataobject(ReconReportGenerationData)

Data returned when a reconciliation report generation request is accepted.

errorsArray of any, <= 0 items

warningsArray of any, <= 0 items

Response

{
  "meta": {
    "ruid": "string"
  },
  "data": {
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "report_status": "GENERATING"
  },
  "errors": [],
  "warnings": []
}