{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Search for transfers Beta","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"search-for-transfers-beta","__idx":0},"children":["Search for 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":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use the /transfers/search endpoint to search for available airport transfers and point-to-point rides. Display the returned options to travellers and redirect them to Booking.com to complete the booking."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Transfers API – Beta access"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Transfers API is currently available to selected partners as part of the Beta collection."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Active development:"]}," The API is under active development and may change."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Available flow:"]}," Search, look and redirect is currently available through the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2-beta/demand-api/transfers/searchtransfers"},"children":["/transfers/search"]}," endpoint."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Access:"]}," Access may be restricted to approved partners.Contact your Partnership Manager to request access."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Updates:"]}," Check the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/whats-new/changelog"},"children":["Demand API Changelog"]}," regularly for the latest changes."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The /transfers/search endpoint returns resolved journey details, available vehicle options, capacity, prices, cancellation information, an expiry time, and a Booking.com URL for each vehicle option."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint-overview","__idx":1},"children":["Endpoint overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the following operation to search for transfers:"]},{"$$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":["Method"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.2-beta/demand-api/transfers/searchtransfers"},"children":["/transfers/search"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Demand API bearer-token authentication. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/development-guide/authentication"},"children":["See the authentication guide"]}," for details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required headers"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer <API_KEY>"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Affiliate-Id: <AFFILIATE_ID>"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request body"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JSON"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Response"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available transfers and redirect URLs"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For authentication details, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/development-guide/authentication"},"children":["Authentication and authorisation"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-the-integration-works","__idx":2},"children":["How the integration works"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Collect the traveller’s journey, passenger, currency, language, and booker-country details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send a request to /transfers/search."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display the returned resolved route, vehicle options, prices, capacity, and cancellation policy."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that the results have not expired before displaying them."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Let the traveller select a vehicle option."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Redirect the traveller using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}," returned for that selected option."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The traveller completes the reservation on Booking.com."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/development-guide/application-flows/search-look-redirect"},"children":["Search, look and redirect flow"]},". The endpoint does not create a booking through the Demand API."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request","__idx":3},"children":["Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request body is JSON and must contain:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["route"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passengers"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker.country"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language"]}," field defaults to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en-gb"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"minimum-one-way-request","__idx":4},"children":["Minimum one-way request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"route\": {\n    \"legs\": [\n      {\n        \"pickup\": {\n          \"location\": {\n            \"airport\": \"AMS\"\n          },\n          \"datetime\": \"2026-09-27T14:30:00\"\n        },\n        \"dropoff\": {\n          \"location\": {\n            \"coordinates\": {\n              \"latitude\": 52.3676,\n              \"longitude\": 4.9041\n            }\n          }\n        }\n      }\n    ]\n  },\n  \"passengers\": 3,\n  \"currency\": \"EUR\",\n  \"booker\": {\n    \"country\": \"ro\"\n  }\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"required-fields","__idx":5},"children":["Required fields"]},{"$$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":"Field"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"120px"}},"children":[" Field"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Format"},"children":["Format"]},{"$$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":"code","attributes":{},"children":["route.legs"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The journey legs in travel order. One item represents a one-way journey; two items represent a return journey."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passengers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Integer, minimum 1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The number of passengers travelling. The response only includes vehicles with sufficient passenger capacity."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 4217 currency code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currency used for prices in the response. Supported currencies are listed below."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker.country"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 3166-1 alpha-2 country code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Booker’s country, used for pricing context and applicable tax and fee display requirements."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"optional-fields","__idx":6},"children":["Optional fields"]},{"$$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":"Field"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"120px"}},"children":[" Field"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Format"},"children":["Format"]},{"$$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":"code","attributes":{},"children":["language"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Language identifier, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["es"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The language used for the search results and Booking.com redirect URL. Defaults to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en-gb"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"define-the-journey","__idx":7},"children":["Define the journey"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["route.legs"]}," to define the journey."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A one-way journey contains one leg."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A return journey contains two legs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Legs must be in travel order."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Every leg must include its own pickup location, pickup datetime, and drop-off location."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"one-way-journey","__idx":8},"children":["One-way journey"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The first leg must include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The pick-up location."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The local pick-up date and time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The drop-off location."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"route\": {\n    \"legs\": [\n      {\n        \"pickup\": {\n          \"location\": {\n            \"airport\": \"AMS\"\n          },\n          \"datetime\": \"2026-12-12T14:30:00\"\n        },\n        \"dropoff\": {\n          \"location\": {\n            \"coordinates\": {\n              \"latitude\": 52.3676,\n              \"longitude\": 4.9041\n            }\n          }\n        }\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"return-journey","__idx":9},"children":["Return journey"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A return journey contains two legs:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The outbound leg."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The return leg."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both legs must include their own pick-up location, pick-up date and time, and drop-off location."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a standard return journey, the second leg’s locations must match the outbound leg in reverse:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Return pickup = outbound drop-off."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Return drop-off = outbound pickup."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"route\": {\n    \"legs\": [\n      {\n        \"pickup\": {\n          \"location\": {\n            \"airport\": \"MAN\"\n          },\n          \"datetime\": \"2026-12-12T10:00:00\"\n        },\n        \"dropoff\": {\n          \"location\": {\n            \"google_place_id\": \"ChIJVYR0dR3hxUcRwz_xGKN6B_s\"\n          }\n        }\n      },\n      {\n        \"pickup\": {\n          \"location\": {\n            \"google_place_id\": \"ChIJVYR0dR3hxUcRwz_xGKN6B_s\"\n          },\n          \"datetime\": \"2026-12-15T16:15:00\"\n        },\n        \"dropoff\": {\n          \"location\": {\n            \"airport\": \"MAN\"\n          }\n        }\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The return pickup datetime must be later than the outbound pickup datetime. The API may also reject a return pickup that is too soon after the outbound pickup."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"specify-journey-locations","__idx":10},"children":["Specify journey locations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each pick-up or drop-off location must contain exactly one of the following properties:"]},{"$$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":"Field"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"120px"}},"children":[" Field"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Format"},"children":["Format"]},{"$$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":"code","attributes":{},"children":["airport"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["IATA airport code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies an airport, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AMS"]}," for Amsterdam Airport Schiphol."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["google_place_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Google Place ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies a place using its Google Place ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coordinates"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies a location using geographic coordinates."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not combine location types. For example, a location must not contain both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["airport"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["google_place_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coordinates"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"airport","__idx":11},"children":["Airport"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["airport"]}," to identify a location by its IATA airport code."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"location\": {\n    \"airport\": \"AMS\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"google-place-id","__idx":12},"children":["Google Place ID"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["google_place_id"]}," to identify a location by its Google Place ID."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"location\": {\n    \"google_place_id\": \"ChIJVYR0dR3hxUcRwz_xGKN6B_s\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"coordinates","__idx":13},"children":["Coordinates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coordinates"]}," to identify a location by latitude and longitude."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"location\": {\n    \"coordinates\": {\n      \"latitude\": 52.3676,\n      \"longitude\": 4.9041\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use accurate coordinates and a resolvable Google Place ID. The API may reject a route when either location cannot be resolved or is outside the supported service region."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"specify-pickup-date-and-time","__idx":14},"children":["Specify pickup date and time"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup.datetime"]}," for the local pickup date and time of each leg."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the following format:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DDTHH:mm:ss"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"datetime\": \"2026-12-12T14:30:00\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not include a time zone or UTC offset. The API interprets the value using the local time zone of the pick-up location."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a return journey, provide a separate ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup.datetime"]}," for each leg."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"specify-the-number-of-passengers","__idx":15},"children":["Specify the number of passengers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passengers"]}," to specify the number of travellers requiring the transfer."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"passengers\": 3\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The value must be at least ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response contains vehicle options with sufficient passenger capacity for the requested number of passengers. Use the returned ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_passengers"]}," value when displaying each option."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"specify-currency-and-language","__idx":16},"children":["Specify currency and language"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"currency","__idx":17},"children":["Currency"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}," to specify the currency used for prices in the response."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The current schema lists these ISO 4217 currency codes:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUD"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CAD"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHF"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLP"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CNY"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CZK"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DKK"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EGP"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EUR"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GBP"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HKD"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HUF"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IDR"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ILS"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INR"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ISK"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JPY"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KRW"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MAD"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MXN"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOK"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NZD"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PLN"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QAR"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RON"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RSD"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SAR"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SEK"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SGD"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["THB"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TRY"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TWD"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UAH"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ZAR"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"currency\": \"EUR\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you provide an unsupported currency, the API returns a 400 Bad Request response with an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_parameter"]}," error."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The supported currencies may change over time. Do not hardcode the list in your integration. Handle an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_parameter"]}," response gracefully if a currency is no longer supported."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"language","__idx":18},"children":["Language"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language"]}," to specify the language used for the search results and Booking.com redirect URL."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"language\": \"es\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you omit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language"]},", the API defaults to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en-gb"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"specify-the-booker","__idx":19},"children":["Specify the booker"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booker.country"]}," to provide the booker’s two-letter country code."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"booker\": {\n    \"country\": \"ro\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The booker country provides context for pricing and for displaying applicable taxes and fees."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"transfers-api-response","__idx":20},"children":["Transfers API response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful response contains a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," and a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," object."]},{"$$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":"Field"},"children":["Field"]},{"$$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":"code","attributes":{},"children":["request_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique identifier for the request. Provide it when contacting support."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currency used for the returned prices."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.expires_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Time at which the search results expire."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.route"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Resolved journey route and estimated leg details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.vehicle_options"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available vehicle options, capacities, prices, and redirect URLs."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.cancellation_policy"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancellation policy applying to the available vehicle options."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-response","__idx":21},"children":["Example response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01fr9ez700exycb98w90w5r9sh\",\n  \"data\": {\n    \"currency\": \"EUR\",\n    \"expires_at\": \"2026-12-12T10:30:00Z\",\n    \"route\": {\n      \"legs\": [\n        {\n          \"pickup\": {\n            \"datetime\": \"2026-12-12T14:30:00\",\n            \"location\": {\n              \"name\": \"Amsterdam Airport Schiphol (AMS)\",\n              \"address\": \"Evert van de Beekstraat 202, 1118 CP Schiphol, Netherlands\",\n              \"city\": \"Schiphol\",\n              \"country\": \"nl\",\n              \"coordinates\": {\n                \"latitude\": 52.3105,\n                \"longitude\": 4.7683\n              },\n              \"iata\": \"AMS\"\n            }\n          },\n          \"dropoff\": {\n            \"location\": {\n              \"name\": \"Booking.com HQ\",\n              \"address\": \"Herengracht 597, 1017 CE Amsterdam, Netherlands\",\n              \"city\": \"Amsterdam\",\n              \"country\": \"nl\",\n              \"coordinates\": {\n                \"latitude\": 52.3676,\n                \"longitude\": 4.9041\n              },\n              \"iata\": null\n            }\n          },\n          \"duration\": null,\n          \"distance\": null\n        }\n      ]\n    },\n    \"vehicle_options\": [\n      {\n        \"name\": \"Standard\",\n        \"max_passengers\": 4,\n        \"max_luggage\": 3,\n        \"price\": 45.50,\n        \"url\": \"https://taxis.booking.com/search/...\"\n      }\n    ],\n    \"cancellation_policy\": {\n      \"type\": \"free_cancellation\",\n      \"details\": {\n        \"context\": \"before_pickup\",\n        \"duration\": \"PT48H\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"interpret-the-response","__idx":22},"children":["Interpret the response"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"search-result-expiry","__idx":23},"children":["Search result expiry"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expires_at"]}," is the expiry timestamp for the search results. It uses a timezone-aware date-time, for example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"expires_at\": \"2026-09-20T10:30:00Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After expiry, prices and availability may change. Run a new search before showing stale results or relying on a previously returned option."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"resolved-route","__idx":24},"children":["Resolved route"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response contains the resolved route and its journey legs."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each leg includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The pickup datetime and resolved pickup location."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The resolved drop-off location."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["duration"]},", an estimated travel time in minutes, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["distance"]},", an estimated distance in kilometres, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Resolved pickup and drop-off locations include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coordinates"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["city"]},", which may be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iata"]},", which contains a three-letter airport code for airports and is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," for non-airport locations"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The pickup datetime is expressed in the local time of the pickup location and does not include a timezone or UTC offset."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response does not include a separate drop-off datetime. The current transfer search returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," for both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["duration"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["distance"]},", so a drop-off time cannot currently be derived from the response. If a future response provides a duration, any derived drop-off time must be presented as an estimate."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"vehicle-options","__idx":25},"children":["Vehicle options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vehicle_options"]}," array contains the available vehicle options for the journey. Options are sorted by price, cheapest first."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each option includes:"]},{"$$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":"Field"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"120px"}},"children":[" Field"]}]},{"$$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":"code","attributes":{},"children":["name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The display name of the vehicle option."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_passengers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The maximum number of passengers the vehicle can accommodate."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_luggage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The maximum number of standard suitcases the vehicle can accommodate."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The total price in the requested currency. For a return journey, this covers both the outbound and return legs."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Booking.com URL for the selected vehicle option. Use the returned URL unchanged."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"vehicle-options-1","__idx":26},"children":["Vehicle options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vehicle_options"]}," array contains the available vehicle options for the journey."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each option includes:"]},{"$$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":"Field"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"120px"}},"children":[" Field"]}]},{"$$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":"code","attributes":{},"children":["name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The display name of the vehicle option."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_passengers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The maximum number of passengers the vehicle can accommodate."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_luggage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The maximum number of standard suitcases the vehicle can accommodate."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The total price in the requested currency."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Booking.com URL for the selected vehicle option."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a return journey, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}," covers both the outbound and return legs."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"cancellation-policy","__idx":27},"children":["Cancellation policy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancellation_policy.type"]}," value is one of:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_cancellation"]}," - Free cancellation is available under the conditions in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["non_refundable"]}," - The transfer is non-refundable."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For free cancellation, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]}," contains the cancellation context and an ISO 8601 duration. For example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"cancellation_policy\": {\n    \"type\": \"free_cancellation\",\n    \"details\": {\n      \"context\": \"before_pickup\",\n      \"duration\": \"PT48H\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PT48H"]}," means that free cancellation is available up to 48 hours before pick-up."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a return journey, the cancellation policy applies to both legs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"redirect-travellers-to-bookingcom","__idx":28},"children":["Redirect travellers to Booking.com"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each vehicle option includes a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}," that redirects the traveller to Booking.com with that vehicle option selected."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"name\": \"Standard\",\n  \"max_passengers\": 4,\n  \"max_luggage\": 3,\n  \"price\": 45.50,\n  \"url\": \"https://taxis.booking.com/search/...\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the returned URL to redirect the traveller to Booking.com and continue with the selected vehicle option."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Search results are indicative and may not reflect live availability."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An option returned by this endpoint might not be available when the traveller follows the redirect URL."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The traveller can view current options, if any, on Booking.com."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":29},"children":["Best practices"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use accurate location data"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the most appropriate supported location type for each pick-up and drop-off point."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Specify exactly one of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["airport"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["google_place_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coordinates"]}," for each location."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provide locations for both legs of a return journey."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For a standard return journey, provide the outbound locations in reverse for the return leg."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use local pick-up times"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provide ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup.datetime"]}," in the local time of the pick-up location."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not include a time zone or UTC offset."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provide a separate pick-up date and time for each journey leg."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keep availability and prices up to date"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expires_at"]}," before displaying previously retrieved search results."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Run a new search after the results expire."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not assume that prices or availability remain unchanged."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Display vehicle capacity accurately"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_passengers"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_luggage"]}," when displaying vehicle options to travellers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not infer vehicle capacity from the vehicle category or display name."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use the returned redirect URL"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Redirect travellers using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}," returned for their selected vehicle option."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not construct or modify Booking.com transfers booking URLs."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Curious to know more?"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refer to the /transfers/search API reference for the complete request and response schema."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/whats-new/changelog"},"children":["Changelog"]}," for the latest transfers API updates."]}]}]}]},"headings":[{"value":"Search for transfers Beta","id":"search-for-transfers-beta","depth":1},{"value":"Endpoint overview","id":"endpoint-overview","depth":2},{"value":"How the integration works","id":"how-the-integration-works","depth":2},{"value":"Request","id":"request","depth":2},{"value":"Minimum one-way request","id":"minimum-one-way-request","depth":3},{"value":"Required fields","id":"required-fields","depth":3},{"value":"Optional fields","id":"optional-fields","depth":3},{"value":"Define the journey","id":"define-the-journey","depth":3},{"value":"One-way journey","id":"one-way-journey","depth":4},{"value":"Return journey","id":"return-journey","depth":4},{"value":"Specify journey locations","id":"specify-journey-locations","depth":3},{"value":"Airport","id":"airport","depth":4},{"value":"Google Place ID","id":"google-place-id","depth":4},{"value":"Coordinates","id":"coordinates","depth":4},{"value":"Specify pickup date and time","id":"specify-pickup-date-and-time","depth":3},{"value":"Specify the number of passengers","id":"specify-the-number-of-passengers","depth":3},{"value":"Specify currency and language","id":"specify-currency-and-language","depth":3},{"value":"Currency","id":"currency","depth":4},{"value":"Language","id":"language","depth":4},{"value":"Specify the booker","id":"specify-the-booker","depth":3},{"value":"Transfers API response","id":"transfers-api-response","depth":2},{"value":"Example response","id":"example-response","depth":3},{"value":"Interpret the response","id":"interpret-the-response","depth":3},{"value":"Search result expiry","id":"search-result-expiry","depth":4},{"value":"Resolved route","id":"resolved-route","depth":4},{"value":"Vehicle options","id":"vehicle-options","depth":4},{"value":"Vehicle options","id":"vehicle-options-1","depth":4},{"value":"Cancellation policy","id":"cancellation-policy","depth":4},{"value":"Redirect travellers to Booking.com","id":"redirect-travellers-to-bookingcom","depth":3},{"value":"Best practices","id":"best-practices","depth":2}],"frontmatter":{"title":"Search for transfers","description":"Learn how to use the /transfers/search endpoint to find available transfers that match a traveller's route, pick-up date and time, and passenger requirements, and redirect travellers to Booking.com to complete their booking.","tags":["demand-api","transfers","taxi-transfers","search","request","response","vehicle-options","examples","redirect"],"api":["/transfers/search"],"keywords":["transfers search","private transfers","airport transfers","one-way journey","return journey","vehicle options","transfers prices","cancellation policy","Booking.com redirect"],"x-redocly":{"seo":{"title":"Private transfer search guide - Booking.com Demand API","description":"Learn how to use the /transfers/search endpoint to search for transfers, define journey locations, retrieve vehicle options and prices, and redirect travellers to Booking.com."},"audience":["developer","partner","integrator"],"apiVersion":"beta, v3.3","product":"transfers"},"seo":{"title":"Search for transfers Beta"}},"lastModified":"2026-10-06T10:18:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/transfers/search-transfers","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}