{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"About transfers Beta","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"about-transfers-beta","__idx":0},"children":["About transfers ",{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#fbbf24","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["Beta"]},"  ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/taxi-journey.6c44a0dc720e34dd88996977c27456623629f667b00dadfe26f0ebc72b633b31.31468193.png","alt":"transfer journey","style":{"width":"15%","height":"auto","marginBottom":"-1rem","marginLeft":"7rem"}},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enable travellers to search for transfers, compare vehicle options and complete their booking on Booking.com."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"demand-api-for-transfers","__idx":1},"children":["Demand API for transfers"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Transfers API collection – Beta access"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Transfers API collection is currently available in Beta to selected partners as part of an early access pilot."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pilot phase"]}," - The API is under active development and subject to change."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Available flow"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Search and redirect is currently available through the /transfers/search endpoint."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Access"]}," - Only approved partners can use this API collection.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact your Partnership Manager to request access."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frequent updates"]}," - Documentation and API specifications may be updated regularly during the pilot.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/whats-new/changelog"},"children":["Changelog"]}," periodically for the latest updates."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Transfers API collection enables you to offer transfers from airports, cities and other locations within your application."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Search for available transfers based on:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The traveller's pick-up and drop-off locations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The journey date and time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The number of passengers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The requested currency."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The booker's country."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can display the returned journey details, vehicle options, prices and cancellation policies in your application."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Travellers can then select an option and continue to Booking.com to complete their booking."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-benefits","__idx":2},"children":["Key benefits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With the Transfers API collection, you can:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Offer one-way and return transfers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Search using airports, Google Place IDs or geographic coordinates."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Find vehicle options with sufficient capacity for the requested number of passengers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display maximum passenger and luggage capacity."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Show prices in the traveller's requested currency."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display resolved pick-up and drop-off locations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Show the estimated journey duration and distance for each journey leg."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display the cancellation policy for each available vehicle option."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Redirect travellers to Booking.com to complete their booking."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-can-you-build","__idx":3},"children":["What can you build?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the Transfers API collection to power experiences such as:"]},{"$$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":"Use case"},"children":["Use case"]},{"$$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":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Airport transfer search"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Let travellers search for transfers between an airport and their accommodation or another destination."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Travel itinerary add-ons"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Offer transfers as an optional service alongside accommodation, flights or other travel services."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Comparison experiences"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Display available vehicle options, prices and capacities so travellers can compare transfer options."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Branded travel journeys"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Build a transfers search experience using your own branding and user interface, then redirect travellers to Booking.com to complete the booking."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pre-trip planning"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Help travellers arrange transport for upcoming one-way or return journeys."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"who-is-this-for","__idx":4},"children":["Who is this for?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Transfers API collection is recommended for existing Demand API Affiliate Partners who want to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Extend their travel services offering with airport and local transfers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Improve the traveller journey by offering transport options alongside other travel services."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Help travellers compare vehicle capacity, prices and cancellation conditions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Drive additional revenue through relevant travel add-ons."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Offer a branded search experience while relying on Booking.com to complete the booking."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integration-flows","__idx":5},"children":["Integration flows"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Transfers API collection supports the Search, look and redirect flow in Beta. Transfers order reporting is available through the Orders API in v3.2."]},{"$$mdtype":"Tag","name":"div","attributes":{"style":{"display":"flex","gap":"2rem","flexWrap":"wrap"}},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/transfers/about-transfers#search-look-and-redirect-flow-beta","style":{"textDecoration":"none","color":"inherit","flex":"1","minWidth":"280px"}},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"border":"2px solid #fbbf24","borderRadius":"8px","padding":"1rem","height":"100%","color":"inherit"}},"children":[{"$$mdtype":"Tag","name":"h4","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#fbbf24","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["Beta"]}," |\n        Search, look & redirect\n      "]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Search for transfers and display vehicle options."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Redirect travellers to Booking.com to complete their order."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Beta – ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["special permission required."]}]}]}]}]},{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/transfers/about-transfers#reporting-and-reconciliation-v32","style":{"textDecoration":"none","color":"inherit","flex":"1","minWidth":"280px"}},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"border":"2px solid #0070c9","borderRadius":"8px","padding":"1rem","height":"100%","color":"inherit"}},"children":[{"$$mdtype":"Tag","name":"h4","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"backgroundColor":"#0070c9","color":"white","fontSize":"0.8rem","padding":"0.2rem 0.5rem","borderRadius":"4px"}},"children":["v3.2"]}," | \n        Reporting and reconciliation\n      "]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve order information for reporting, reconciliation and operational workflows."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the /orders/details endpoint."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Available in production in v3.2."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"search-look-and-redirect-flow-beta","__idx":6},"children":["Search, look and redirect flow (Beta)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Search for transfers using the traveller's journey details and passenger requirements."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Display the returned route, vehicle options, prices, journey details and cancellation policy, then redirect the traveller to Booking.com to complete the order."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/transfers/search-transfers"},"children":["Search for transfers integration guide"]}," for request requirements, search criteria, response fields and implementation examples."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reporting-and-reconciliation-v32","__idx":7},"children":["Reporting and reconciliation (v3.2)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the /orders/details endpoint to retrieve transfers order data for reporting, reconciliation and operational workflows."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A transfer order may contain multiple journey legs:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The order-level price, start, end and status are aggregated across all legs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each leg has its own reservation, leg identifier and lifecycle."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For accurate reporting and tracking, inspect both the order-level information and the individual transfer legs."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/order-details"},"children":["Run order reports"]}," guide for request examples and reporting use cases."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":8},"children":["Next steps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Try the transfers API collection:"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Read the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/transfers/search-transfers"},"children":["Search for transfers integration guide"]}," for request requirements, response fields and examples."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Read the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/development-guide/application-flows/reporting"},"children":["Reporting and reconciliation integration guide"]}," to learn how to use order data in back-office workflows."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Explore the /transfers/search API reference."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/whats-new/changelog"},"children":["Changelog"]}," for the latest Beta updates."]}]}]}]},"headings":[{"value":"About transfers Beta","id":"about-transfers-beta","depth":1},{"value":"Demand API for transfers","id":"demand-api-for-transfers","depth":2},{"value":"Key benefits","id":"key-benefits","depth":2},{"value":"What can you build?","id":"what-can-you-build","depth":2},{"value":"Who is this for?","id":"who-is-this-for","depth":2},{"value":"Integration flows","id":"integration-flows","depth":2},{"value":"Search, look and redirect flow (Beta)","id":"search-look-and-redirect-flow-beta","depth":2},{"value":"Reporting and reconciliation (v3.2)","id":"reporting-and-reconciliation-v32","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"About transfers","description":"Use the Demand API to search for transfers, display available vehicle options and redirect travellers to Booking.com to complete their booking.","tags":["demand-api","transfers","taxi-transfers","search","redirect","reporting"],"api":["/transfers/search","/orders/details"],"keywords":["transfers API","private transfers","taxis","airport transfers","transfers search","one-way journey","return journey","vehicle options","transfers prices","cancellation policy","Booking.com redirect","transfers order reporting","transfers reconciliation"],"x-redocly":{"seo":{"title":"About the transfers API | Booking.com Demand API","description":"Learn how to use the transfers API collection to search for private transfers, display vehicle options, redirect travellers to Booking.com and retrieve transfers order data for reporting."},"audience":["developer","partner","integrator"],"apiVersion":["Beta","v3.3"],"product":"transfers"},"seo":{"title":"About transfers Beta"}},"lastModified":"2026-10-06T10:18:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/transfers/about-transfers","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}