{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown","product":"demand-api","vertical":"transfers","endpoint":"/transfers/search","apiVersion":"beta","audience":"developer, partners, business"},"seo":{"title":"Transfers search error handling","siteUrl":"https://developers.booking.com","description":"Understand errors returned by transfers search and how to correct your request or choose another route.","keywords":"transfers search errors, transfer route not resolvable, transfer location not resolvable, transfers search troubleshooting"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"transfers-search-error-handling","__idx":0},"children":["Transfers search error handling"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this guide to understand errors returned by the transfers search endpoint and decide what to do next."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Beta version"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transfers search is a Beta endpoint. Its request and response structures may change, including through breaking changes. Check the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/whats-new/changelog"},"children":["Changelog"]}," for updates."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-read-an-error-response","__idx":1},"children":["How to read an error response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An error response includes a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," and an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errors"]}," array. Each error contains:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," - A machine-readable error identifier. Transfers search validation errors use one of these IDs:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["missing_parameter"]}," - a required field is missing."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_parameter"]}," - a field has an invalid value, format or relationship to another field."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," - A human-readable explanation, which may identify the affected parameter."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, an invalid pick-up date and time returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_parameter"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01kjan7r7yvff5yg95gxy1cjhy\",\n  \"errors\": [\n    {\n      \"id\": \"invalid_parameter\",\n      \"message\": \"Parameter 'route.legs[0].pickup.datetime' is invalid. The pick-up date and time must not be in the past.\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Names such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["location_not_resolvable"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["region_not_supported"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["route_not_resolvable"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return_pickup_too_soon"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency_not_supported"]}," may appear as example names in the API definition. They are illustrative labels, not values returned in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errors[].id"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"general-approach","__idx":2},"children":["General approach"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Read the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," to determine whether a required field is missing or a value is invalid."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," to identify the parameter or issue - Correct the request using the guidance below."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send the request again after correcting it. Repeating the same request unchanged is unlikely to resolve a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}," error."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the error persists or the response is unexpected, record the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," and contact support."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"missing-parameters","__idx":3},"children":["Missing parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["missing_parameter"]}," error means that a required field is missing from the request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A transfers search request requires:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["route"]},", containing one leg for a one-way journey or two legs for a return journey."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup.location"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup.datetime"]}," for each leg."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dropoff.location"]}," for each leg."]},{"$$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":["For a return journey, include both legs. Each leg must specify its own pick-up and drop-off locations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example of missing parameters error response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01kjan7r7yvff5yg95gxy1cjhy\",\n  \"errors\": [\n    {\n      \"id\": \"missing_parameter\",\n      \"message\": \"Parameter 'route.legs[1].pickup.location' is missing.\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add the missing field identified in the error message."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For a return journey, check that the second leg includes both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup.location"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dropoff.location"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/beta/demand-api/transfers"},"children":["API reference"]}," for the required fields and accepted formats."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"invalid-parameters","__idx":4},"children":["Invalid parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_parameter"]}," error means a field is present but its value, format or relationship to another field is invalid. The error message identifies the parameter when possible."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"invalid-request-structure-or-format","__idx":5},"children":["Invalid request structure or format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A request can be invalid if a field has the wrong type or format, does not meet field requirements, or conflicts with another field."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the request:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["route.legs"]}," array must contain one leg for a one-way journey or two legs for a return journey."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each location object must 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"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, this location is invalid because it specifies two identifiers:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"airport\": \"AMS\",\n  \"coordinates\": {\n    \"latitude\": 52.3676,\n    \"longitude\": 4.9041\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Another example would be when the pick-up date and/or time do not use the format ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DDTHH:mm:ss"]}," (without a time zone or UTC offset)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example would return this error:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01kjan7r7yvff5yg95gxy1cjhy\",\n  \"errors\": [\n    {\n      \"id\": \"invalid_parameter\",\n      \"message\": \"Parameter 'route.legs[0].pickup.datetime' is invalid. 'route.legs[0].pickup.datetime' must match the format yyyy-mm-dd'T'HH:mm:ss.\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the field name, data type, format and accepted values."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use a real calendar date and time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provide the pick-up date and time in the local time zone of the pick-up location. Do not add a time zone or UTC offset."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/beta/demand-api/transfers"},"children":["API reference"]}," for the required fields and accepted formats."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"passenger-count-exceeds-the-limit","__idx":6},"children":["Passenger count exceeds the limit"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Transfer search request supports between 1 and 8 passengers. If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passengers"]}," is greater than 8, the response returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_parameter"]}," with the following message."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01kjan7r7yvff5yg95gxy1cjhy\",\n  \"errors\": [\n    {\n      \"id\": \"invalid_parameter\",\n      \"message\": \"The number of passengers must be 8 or fewer.\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that the passenger count is accurate and is between 1 and 8."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If more than 8 people are travelling, arrange separate searches only if your product supports multiple transfer journeys. Do not reduce the passenger count below the travellers' actual requirements."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pick-up-date-and-time-in-the-past","__idx":7},"children":["Pick-up date and time in the past"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The pick-up date and time must not be in the past."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provide a future pick-up date and time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that the value is interpreted in the local time zone of the pick-up location."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"location-cannot-be-resolved","__idx":8},"children":["Location cannot be resolved"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a location cannot be resolved, the response returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_parameter"]}," with a message explaining that the transfer service could not resolve a specified pick-up or drop-off location."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Possible causes include an airport code that does not identify a real airport, a Google Place ID that cannot be resolved, or coordinates that do not identify a usable location."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01kjan7r7yvff5yg95gxy1cjhy\",\n  \"errors\": [\n    {\n      \"id\": \"invalid_parameter\",\n      \"message\": \"Parameter 'route.legs[0].pickup.location' is invalid. The location could not be resolved.\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that the location identifier is correct."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For an airport, provide a valid three-letter IATA airport code. You can use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/3.3/demand-api/commonlocations/common/locations/airports"},"children":["common/locations/airports endpoint"]}," to check the right code."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For coordinates, check that the latitude and longitude identify the intended location."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For a Google Place ID, check that it identifies the intended place."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the location still cannot be resolved, try another supported identifier or a nearby location."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pick-up-or-drop-off-location-not-supported","__idx":9},"children":["Pick-up or drop-off location not supported"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the transfer service does not support the requested pick-up or drop-off location, the response returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_parameter"]},". The message may not identify which end of the route caused the error."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01kjan7r7yvff5yg95gxy1cjhy\",\n  \"errors\": [\n    {\n      \"id\": \"invalid_parameter\",\n      \"message\": \"Parameter 'route' is invalid. The pick-up or drop-off location is not supported.\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check whether transfer services are supported for both locations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Try a nearby location where transfer services are available, such as a supported airport."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you cannot determine which location is unsupported, test the pick-up and drop-off locations separately."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"no-route-could-be-found","__idx":10},"children":["No route could be found"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the locations are resolved but the transfer service cannot find a route between them, the response returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_parameter"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01kjan7r7yvff5yg95gxy1cjhy\",\n  \"errors\": [\n    {\n      \"id\": \"invalid_parameter\",\n      \"message\": \"Parameter 'route' is invalid. No route could be found between the pick-up and drop-off locations.\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that the pick-up and drop-off locations are correct."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Try a different pick-up or drop-off location, or another route."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not retry the same request unchanged unless you have reason to believe the failure was temporary."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"return-leg-locations-do-not-match-the-outbound-leg","__idx":11},"children":["Return leg locations do not match the outbound leg"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a return journey, the second leg must reverse the outbound route. The locations must match exactly, including the identifier type and value:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The return pick-up must use the same location identifier and value as the outbound drop-off."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The return drop-off must use the same location identifier and value as the outbound pick-up."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, if the outbound drop-off is specified as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"airport\": \"AMS\""]},", specify the return pick-up using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"airport\": \"AMS\""]}," as well. Specifying the same apparent value using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["google_place_id"]}," does not match the airport identifier."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Compare the outbound and return locations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reuse the same identifier type and value for each matching location."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that the return pick-up matches the outbound drop-off, and that the return drop-off matches the outbound pick-up."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"return-pick-up-is-not-later-than-the-outbound-pick-up","__idx":12},"children":["Return pick-up is not later than the outbound pick-up"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The return pick-up date and time must be later than the outbound pick-up date and time. A return pick-up at the same time as, or earlier than, the outbound pick-up is invalid."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set the return pick-up to a later date and time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that both values are correct and use the local time zone of the relevant pick-up location."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"return-pick-up-is-too-soon","__idx":13},"children":["Return pick-up is too soon"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the interval between the outbound and return pick-ups does not meet the transfer service's minimum requirement, the response returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_parameter"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01kjan7r7yvff5yg95gxy1cjhy\",\n  \"errors\": [\n    {\n      \"id\": \"invalid_parameter\",\n      \"message\": \"Parameter 'route.legs[1].pickup.datetime' is invalid. The return pick-up is too soon after the outbound pick-up.\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose a later return pick-up time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the minimum interval is not documented, increase the gap between the two pick-ups and retry the request."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"currency-is-not-supported","__idx":14},"children":["Currency is not supported"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the requested currency is not supported for transfers search, the response returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_parameter"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The currently documented supported currencies are AUD, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, JPY, NOK, NZD, PLN, RON, SEK, SGD, THB, TWD, USD and ZAR. This list may change."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example of error:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01kjan7r7yvff5yg95gxy1cjhy\",\n  \"errors\": [\n    {\n      \"id\": \"invalid_parameter\",\n      \"message\": \"Parameter 'currency' is invalid. The currency is not supported for transfer searches.\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use a supported currency."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the latest API reference for the current supported currencies."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Avoid hardcoding the supported currency list in your integration."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"no-transfer-options-returned","__idx":15},"children":["No transfer options returned"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful search may not return any vehicle options for the requested route and pick-up time."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Search results are based on predicted availability and pricing, and options may differ when the traveller follows a Booking.com redirect URL. In some cases, no options may be available on Booking.com."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that the route, pick-up date and time, and passenger count are correct."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If appropriate, ask the traveller to choose a nearby pick-up or drop-off location, a different route or a different time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Make it clear that search results are based on predicted availability and pricing."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"server-errors","__idx":16},"children":["Server errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]}," response indicates an internal server error. It does not identify a request field that you can correct."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01kjan66dedrpbwv4m1966dzw3\",\n  \"errors\": [\n    {\n      \"id\": \"500\",\n      \"message\": \"Internal server error. Try again later or contact support.\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retry the request later."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the error continues, contact support and provide the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Avoid retrying continuously. Handle repeated failures according to your integration's retry policy."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting-checklist","__idx":17},"children":["Troubleshooting checklist"]},{"$$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":"Check"},"children":["Check"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to do"},"children":["What to do"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A required field is missing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add the field identified in the error message. For a return journey, include both legs and all required locations."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A location object is invalid"]},{"$$mdtype":"Tag","name":"td","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"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The passenger count is invalid"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Provide a value from 1 to 8."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A date or time is invalid"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use a real future date in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DDTHH:mm:ss"]}," format and the local time zone of the pick-up location."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A location cannot be resolved"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the airport code, Google Place ID or coordinates. If needed, try another supported identifier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The region or route is unsupported"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check both locations and try a supported nearby location or another route."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The return leg is invalid"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reverse the outbound locations, using the same identifier type and value, and set the return pick-up later than the outbound pick-up."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The currency is unsupported"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use a currency listed in the current API reference."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]}," response persists"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retry later, then contact support with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," if the error continues."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":18},"children":["Best practices"]},{"$$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":"Practice"},"children":["Practice"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Recommendation"},"children":["Recommendation"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate before sending"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check required fields, formats, dates, locations and return-leg relationships before calling the endpoint."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use the returned error ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Handle ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["missing_parameter"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_parameter"]}," as the actual validation IDs. Do not check for illustrative example names as error IDs."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Correct requests before retrying"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fix the reported issue before resending a request that returned ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Match return locations exactly"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reuse the same identifier type and value when specifying the same location in both legs."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Distinguish location and route issues"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A location may be unresolved, unsupported for transfer services, or resolved without a route between the locations. Follow the guidance for the message returned."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Keep the request ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Record the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," when investigating unexpected or persistent errors."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Account for Beta changes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the Changelog for changes to the transfers search request, response and error examples."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-resources","__idx":19},"children":["Related resources"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/support/error-handling/error-codes"},"children":["General client error codes and examples"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":["Error handling"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/whats-new/changelog"},"children":["Changelog"]}]}]}]}]},"headings":[{"value":"Transfers search error handling","id":"transfers-search-error-handling","depth":1},{"value":"How to read an error response","id":"how-to-read-an-error-response","depth":2},{"value":"General approach","id":"general-approach","depth":3},{"value":"Missing parameters","id":"missing-parameters","depth":2},{"value":"Invalid parameters","id":"invalid-parameters","depth":2},{"value":"Invalid request structure or format","id":"invalid-request-structure-or-format","depth":3},{"value":"Passenger count exceeds the limit","id":"passenger-count-exceeds-the-limit","depth":3},{"value":"Pick-up date and time in the past","id":"pick-up-date-and-time-in-the-past","depth":3},{"value":"Location cannot be resolved","id":"location-cannot-be-resolved","depth":3},{"value":"Pick-up or drop-off location not supported","id":"pick-up-or-drop-off-location-not-supported","depth":3},{"value":"No route could be found","id":"no-route-could-be-found","depth":3},{"value":"Return leg locations do not match the outbound leg","id":"return-leg-locations-do-not-match-the-outbound-leg","depth":3},{"value":"Return pick-up is not later than the outbound pick-up","id":"return-pick-up-is-not-later-than-the-outbound-pick-up","depth":3},{"value":"Return pick-up is too soon","id":"return-pick-up-is-too-soon","depth":3},{"value":"Currency is not supported","id":"currency-is-not-supported","depth":3},{"value":"No transfer options returned","id":"no-transfer-options-returned","depth":2},{"value":"Server errors","id":"server-errors","depth":2},{"value":"Troubleshooting checklist","id":"troubleshooting-checklist","depth":2},{"value":"Best practices","id":"best-practices","depth":2},{"value":"Related resources","id":"related-resources","depth":2}],"frontmatter":{"title":"Transfers search error handling","description":"Understand errors returned by transfers search and how to correct your request or choose another route.","tags":["demand-api","transfers","error-handling","troubleshooting"],"api":["/transfers/search"],"keywords":["transfers search errors","transfer route not resolvable","transfer location not resolvable","transfers search troubleshooting"],"metadata":{"product":"demand-api","vertical":"transfers","endpoint":"/transfers/search","apiVersion":"beta","audience":"developer, partners, business"},"seo":{"title":"Transfers search error handling","description":"Understand errors returned by transfers search and how to correct your request or choose another route.","keywords":"transfers search errors, transfer route not resolvable, transfer location not resolvable, transfers search troubleshooting"}},"lastModified":"2026-11-09T13:31:18.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/transfers/transfers-troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}