{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-connectivity/docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"RtB 2.0 API changes","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"rtb-20-api-changes","__idx":0},"children":["RtB 2.0 API changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["RtB 2.0 introduces the RTB flow: a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestType"]}," ","field and a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED_TO_PROCESS"]}," request status, gated behind API version ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2.0.0"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-versioning","__idx":1},"children":["API versioning"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["RtB 2.0 is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["version 2.x"]}," (the RTB flow). To receive the RtB 2.0"," ","features described below (the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestType"]}," field and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED_TO_PROCESS"]}," status), you must send"," ","the following header with your API requests:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"X-Booking-Api-Version: 2.0.0\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Without this header, the API defaults to version ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1.0.1"]}," (version 1.x, the INQUIRY flow), which does not"," ","include RtB 2.0 changes. This ensures existing integrations continue to work without disruption."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the full list of versions and what each version adds, including the"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WITHDRAWN_PENDING_APPROVAL"]}," status added by ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/request-to-book/withdrawal"},"children":["withdrawal"]},", see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/request-to-book/technical-overview#versioning"},"children":["Versioning"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"new-field-requesttype","__idx":2},"children":["New field: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestType"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["RtB 2.0 adds a new field to the Booking Request object returned by the RtB Connectivity API list and"," ","get-by-ID endpoints."]},{"$$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":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestType"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enum: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INQUIRY"]}," | ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RTB"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Location"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Top level of the Booking Request object"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The field tells you which flow to follow for each request:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INQUIRY"]},": the RtB 1.x flow (no availability block while pending)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RTB"]},": the RtB 2.0 flow, where the pending request holds provider-side inventory. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/request-to-book/rtb-2.0/availability-management"},"children":["Availability management"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example (simplified) Booking Request object:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": 123456,\n  \"propertyId\": 654321,\n  \"requestStatus\": \"CREATED\",\n  \"requestType\": \"RTB\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the full object in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/request-to-book/retrieving-booking-requests#bookingrequest-object"},"children":["Booking Request Object reference"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"new-request-status-failed_to_process","__idx":3},"children":["New request status: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED_TO_PROCESS"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED_TO_PROCESS"]}," status covers a rare failure case."]},{"$$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":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Status name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED_TO_PROCESS"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Meaning"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The guest's request was approved by the partner, but Booking.com failed to create a reservation after several attempts. No reservation will be created for this request."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reservation creation after partner approval typically takes between a few seconds and a minute."," ","For RtB 2.0, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED_TO_PROCESS"]}," is important for releasing provider-side availability (see"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/request-to-book/rtb-2.0/availability-management"},"children":["Availability management"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You must:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Extend your internal model to accept this new status."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Handle it in your availability logic (release any holds)."]}]}]},"headings":[{"value":"RtB 2.0 API changes","id":"rtb-20-api-changes","depth":1},{"value":"API versioning","id":"api-versioning","depth":2},{"value":"New field: requestType","id":"new-field-requesttype","depth":2},{"value":"New request status: FAILED_TO_PROCESS","id":"new-request-status-failed_to_process","depth":2}],"frontmatter":{"title":"RtB 2.0 API changes","description":"The API changes introduced by Request to Book 2.0, including the required API version 2.0.0, the new requestType field, and the new FAILED_TO_PROCESS request status.","keywords":{"includes":["requestType","FAILED_TO_PROCESS","X-Booking-Api-Version","2.0.0","RTB","INQUIRY","versioning","request-to-book"]},"seo":{"title":"RtB 2.0 API changes"}},"lastModified":"2026-08-26T11:37:47.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/connectivity/docs/request-to-book/rtb-2.0/api-changes","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}