Skip to content
API REFERENCES/
/Transfers

Transfers

Search for transfer options, including prices, vehicle details, and booking links.

Operations

Beta
Search for transfers

Request

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

The response includes vehicle options, estimated prices, cancellation policies, and Booking.com redirect URLs for completing the booking.

Availability and pricing: Search results are based on predicted availability and pricing. The actual options and prices may differ when the traveller follows the redirect URL. In some cases, no options may be available on Booking.com.

Beta endpoint: This endpoint is part of the Demand API Beta collection. Its request and response structures may change, including breaking changes. See the Changelog for the latest enhancements.

Security
BearerAuth
Headers
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, [ 1 .. 8 ]required

The number of passengers travelling, from 1 to 8. 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: AUD, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, JPY, NOK, NZD, PLN, RON, SEK, SGD, THB, TWD, 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-2)required

Defines the booker context.

curl -i -X POST \
  https://demandapi.booking.com/beta/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": { … }
  }
}