Search for transfers

Request

Search for available transfer options that match the specified route, pick-up date and time, and number of passengers.

The response includes available vehicles, prices, cancellation policies, and a redirect URL that you can use to complete the booking on Booking.com.

Security

BearerAuth

X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/jsonrequired

routeobject(TransfersRouteInput)required

The route for the transfer journey. A route contains one leg for a one-way journey or two legs for a return journey. Every leg must fully specify its own pick-up and drop-off locations, including the return leg. For a return journey, the second leg normally uses the outbound locations in reverse.

passengersinteger, >= 1required

The number of passengers travelling. The response only includes vehicles with sufficient passenger capacity.

Example:3

currencystring or null(currencyId)^[A-Z]{3}$required

The currency used for prices in the response. The Transfers service API currently supports the following ISO 4217 currency codes: AED, AUD, CAD, CHF, CLP, CNY, CZK, DKK, EGP, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MAD, MXN, NOK, NZD, PLN, QAR, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, USD and ZAR. If you provide an unsupported currency, the API returns a 400 Bad Request response with an invalid_parameter error. The supported currencies may change over time, so do not hardcode this list in your integration.

Example:"EUR"

languagestring(languageId)^[a-z]{2}(-[a-z]{2})?$

The language used for the results and Booking.com redirect URL.

Default:"en-gb"

Example:"en-us"

bookerobject(booker-4)required

Defines the booker context.

curl -i -X POST \
  https://demandapi.booking.com/3.2/transfers/search \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "route": {
      "legs": [
        {
          "pickup": {
            "location": {
              "airport": "AMS"
            },
            "datetime": "2026-11-12T10:00:00"
          },
          "dropoff": {
            "location": {
              "coordinates": {
                "latitude": 52.3676,
                "longitude": 4.9041
              }
            }
          }
        }
      ]
    },
    "passengers": 3,
    "currency": "EUR",
    "language": "en-gb",
    "booker": {
      "country": "ro"
    }
  }'

Responses

Successful response.

Bodyapplication/json

request_idstring(requestId)required

Uniquely identifies the request. Please provide this identifier when contacting support.

dataobject(TransfersTripOffer)required

The transfer details, including the route, available vehicle options, prices and cancellation policy.

Response

{
  "request_id": "01m2jeexpm1m2df7992n4xphwh",
  "data": {
    "currency": "EUR",
    "expires_at": "2026-11-11T12:50:29Z",
    "route": { … },
    "vehicle_options": [ … ],
    "cancellation_policy": { … }
  }
}