{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-connectivity/docs/reconciliation-api/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial"]},"type":"markdown"},"seo":{"title":"Checking the status and downloading the payout report","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"This API is in closed beta"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API functionality is in closed beta phase. Currently, the closed beta is available only for select providers. Make sure to direct any questions during the beta phase to your Booking.com contact person via the appropriate channels."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"checking-the-status-and-downloading-the-payout-report","__idx":0},"children":["Checking the status and downloading the payout report"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://payments-api.booking.com/connectivity-payments/recon-reports/{request-id}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Status API allows you to fetch the status of the payout report and download the payout report once it's ready (has ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["READY"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"required-connection-type","__idx":1},"children":["Required connection type"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You need to be connected with the reservations connection type to use this API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information on the connection types, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/connections-api/connections-overview"},"children":["Connections API Overview"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"expiration","__idx":2},"children":["Expiration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Take these expiration times/dates into account:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Download link"]},": Valid for 15 minutes. To download a report after this time, you need to request a new link."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Report request"]},": Identical report requests are cached for 1 hour. If a report is requested with the same filters within one hour, the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," will be returned with the status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]},". If the report is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["READY"]},", the Status API provides the link to download the previous report."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"headers","__idx":3},"children":["Headers"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Header"},"children":["Header"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api-version"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The version of the API. If omitted, defaults to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1.0"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"path-parameters","__idx":4},"children":["Path parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes what elements you must add as path parameters:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Element"},"children":["Element"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required/Optional"},"children":["Required/Optional"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request-id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the identifier of the payout report request."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-example","__idx":5},"children":["Response example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"meta\": {\n    \"ruid\": \"string\"\n  },\n  \"data\": {\n      \"request_id\": \"UUID-R1234\",\n      \"status\": \"READY\",\n      \"updated_at\": \"ISO-8601 timestamp\", \n      \"download_url_expires_at\": \"ISO-8601 timestamp\",\n      \"filename\": \"file.json\", \n      \"download_url\": \"string\"\n  },\n  \"errors\": [\n    {\n      \"description\": \"string\",\n      \"message\": \"\",\n      \"status_code\": 0,\n      \"debug_message\": \"string\"\n    }\n  ],\n  \"warnings\": [\n    {\n      \"message\": \"string\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-elements","__idx":6},"children":["Response elements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes the response elements:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Element"},"children":["Element"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the report status details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["::"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifier of the report request for which the status is retrieved."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["::"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Status of the request: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GENERATING"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["READY"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EMPTY"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ERROR"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["::"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updated_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Timestamp of the last status update."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["::"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["download_url_expires_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Timestamp of when the download link expires."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["::"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filename"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Name of the payout report file."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["::"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["download_url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL to download the payout report."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errors"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains potential errors. These can help you understand what went wrong with your request. For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#response-codes"},"children":["Response codes"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["warnings"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains potential warnings. These can help you improve your requests."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-payout-reports","__idx":7},"children":["Example payout reports"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Download example payout reports to see the structure and format of the data returned by the API:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/reconciliation-api/Payout_from_2026-04-01_until_2026-05-01.json","download":""},"children":["JSON example"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/reconciliation-api/Payout_from_2026-04-01_until_2026-05-01.csv","download":""},"children":["CSV example"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/reconciliation-api/Payout_from_2026-04-01_until_2026-05-01.xls","download":""},"children":["XLS example"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rate-limiting","__idx":8},"children":["Rate limiting"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To prevent excessive load on our systems, we limit the number of API calls that a provider can make per minute. For the Status API, the limit is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["10 requests per minute"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-codes","__idx":9},"children":["Response codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This table lists and describes the response codes that the API can return."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200 OK"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Report status and details retrieved successfully."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400 Bad request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid parameters provided."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401 Unauthorized"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User not authenticated."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403 Forbidden"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User not authorized to access this report."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404 Not Found"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Report ID not found."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["429 Too Many Requests"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rate limit exceeded."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500 Internal server error"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An unexpected error occurred."]}]}]}]}]}]},"headings":[{"value":"Checking the status and downloading the payout report","id":"checking-the-status-and-downloading-the-payout-report","depth":1},{"value":"Required connection type","id":"required-connection-type","depth":2},{"value":"Expiration","id":"expiration","depth":2},{"value":"Headers","id":"headers","depth":2},{"value":"Path parameters","id":"path-parameters","depth":2},{"value":"Response example","id":"response-example","depth":2},{"value":"Response elements","id":"response-elements","depth":2},{"value":"Example payout reports","id":"example-payout-reports","depth":2},{"value":"Rate limiting","id":"rate-limiting","depth":2},{"value":"Response codes","id":"response-codes","depth":2}],"frontmatter":{"excludeFromSearch":true,"sidebar":{"path":"sidebars.yaml"},"seo":{"title":"Checking the status and downloading the payout report"}},"lastModified":"2026-08-04T10:27:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/connectivity/docs/reconciliation-api/checking-the-status-and-downloading-the-payout-report","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}