{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-connectivity/docs/reconciliation-api/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial","admonition"]},"type":"markdown"},"seo":{"title":"Receiving notifications","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":"receiving-notifications","__idx":0},"children":["Receiving notifications"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To start receiving notifications, follow the instructions from the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/notification-service/notification-service-overview"},"children":["Notification service"]}," documentation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the payout report is ready, you will receive a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RECONCILIATION_REPORT_STATUS"]}," notification with the status set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["READY"]},". From this notification, you can download the payout report using the download link."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"expiration","__idx":1},"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 as the previous request within one hour, the previous report is returned (if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["READY"]},"). If it's still generating, the API will return the status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GENERATING"]},".  A notification is sent only for the first identical report."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"notification-details","__idx":2},"children":["Notification details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RECONCILIATION_REPORT_STATUS"]}," notification has:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestId"]},": Specifies the identifier of the payout report request."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reportStatus"]},": Status of the report: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["READY"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ERROR"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EMPTY"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filename"]},": Name of the payout report file (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report.json"]},")."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["downloadUrl"]},": URL to download the reconciliation report."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["downloadUrlExpiresAt"]},": Expiration time of the download URL."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorDetails"]},": Details of the error if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reportStatus"]}," is  ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ERROR"]},"."]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The fields ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filename"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["downloadUrl"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["downloadUrlExpiresAt"]}," are only present when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reportStatus"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["READY"]},". For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ERROR"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EMPTY"]}," statuses, these fields are completely absent from the response."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"requestId\": \"string\",\n  \"reportStatus\": \"READY|ERROR|EMPTY\",\n  \"filename\": \"report.json\",\n  \"downloadUrl\": \"string\",\n  \"downloadUrlExpiresAt\": \"ISO-8601 timestamp\",\n  \"errorDetails\": null\n}\n\n"},"children":[]}]},"headings":[{"value":"Receiving notifications","id":"receiving-notifications","depth":1},{"value":"Expiration","id":"expiration","depth":2},{"value":"Notification details","id":"notification-details","depth":2}],"frontmatter":{"excludeFromSearch":true,"sidebar":{"path":"sidebars.yaml"},"seo":{"title":"Receiving notifications"}},"lastModified":"2026-08-04T10:27:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/connectivity/docs/reconciliation-api/receiving-notifications","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}