Skip to content

Request quotes

Request quotes for a transfer, including return trips and flight lookup.

Updated · 5 min read

You will get prices for a transfer, one per available vehicle category, so the traveller can choose one. You need a staging API key (see Authentication), the pickup and drop-off locations, the local pickup time, and the number of passengers and bags.

Step 1: Request quotes

Send the route, the time and the party to Request quotes. This example asks for a ride from Amsterdam Airport Schiphol to a hotel on the Herengracht, for two adults with two suitcases and one carry-on bag:

POST/quotesReference
Sign in to fill in your staging key. Sign in
curl --request POST \  --url 'https://warpdrive.staging.transferz.com/partners/quotes' \  --header 'Accept: application/json' \  --header 'Content-Type: application/json' \  --header 'X-API-Key: YOUR_STAGING_API_KEY' \  --data '{  "origin": {    "iataCode": "AMS"  },  "destination": {    "address": {      "addressSearchPhrase": "Herengracht 182, Amsterdam",      "countryCode": "NL"    }  },  "pickupDateTime": "2026-12-01T14:30:00",  "adultPassengers": 2,  "childPassengers": 0,  "infantPassengers": 0,  "checkedLuggage": 2,  "carryOnLuggage": 1,  "currencyCode": "EUR"}'
Response 200
{  "id": 905512,  "origin": {    "bookerEnteredAddress": "AMS",    "resolvedAddress": "Amsterdam Airport Schiphol (AMS), Evert van de Beekstraat 202, 1118 CP Schiphol, Netherlands",    "latitude": 52.3105,    "longitude": 4.7683,    "hub": true,    "iataCode": "AMS",    "usedResolutionMethod": "IATA_CODE"  },  "destination": {    "bookerEnteredAddress": "Herengracht 182, Amsterdam",    "resolvedAddress": "Herengracht 182, 1016 BR Amsterdam, Netherlands",    "latitude": 52.3738,    "longitude": 4.8862,    "hub": false,    "iataCode": null,    "usedResolutionMethod": "ADDRESS_PHRASE"  },  "quotes": [    {      "id": 7731201,      "vehicleCategory": "SEDAN",      "vehicleModels": "Toyota Corolla Touring or similar",      "passengerCapacity": 3,      "luggageCapacity": 3,      "price": 57,      "vat": 4.71,      "commission": 5.7,      "currencyCode": "EUR",      "combinedSeatBasedAddonCapacity": 2,      "expires": "2026-11-20T10:45:00",      "availableTravelAddons": [        { "id": 77312011, "type": "MEET_GREET", "price": 15, "commission": 1.5, "maxAllowed": 1 },        { "id": 77312012, "type": "CHILD_SEAT", "price": 10, "commission": 1, "maxAllowed": 2 }      ],      "includedWaitingTimeInMinutes": 60,      "freeCancellationUntil": "2026-11-30T14:30:00",      "instantConfirmation": true,      "pricePerPassenger": false    },    {      "id": 7731202,      "vehicleCategory": "MINIVAN",      "vehicleModels": "Mercedes-Benz V-Class or similar",      "passengerCapacity": 7,      "luggageCapacity": 7,      "price": 79,      "vat": 6.52,      "commission": 7.9,      "currencyCode": "EUR",      "combinedSeatBasedAddonCapacity": 2,      "expires": "2026-11-20T10:45:00",      "availableTravelAddons": [        { "id": 77312021, "type": "MEET_GREET", "price": 15, "commission": 1.5, "maxAllowed": 1 }      ],      "includedWaitingTimeInMinutes": 60,      "freeCancellationUntil": "2026-11-30T14:30:00",      "instantConfirmation": true,      "pricePerPassenger": false    }  ]}

What to send:

  • origin and destination (required). One of them must be a hub: an airport, port or station. Give each location in one way: an iataCode for an airport, an address with an addressSearchPhrase (add countryCode for better matches), a coordinate, or an id such as googlePlaceId, giataId or transferzLocationId. The response shows how each location was resolved; check resolvedAddress before you show the price.
  • pickupDateTime (required): the local time at the pickup location, without an offset. For an airport pickup, suggest a pickup time from the flight.
  • Passengers and luggage: adultPassengers, childPassengers, infantPassengers, checkedLuggage and carryOnLuggage. Only vehicles with room for them are quoted.
  • Optional filters: limitToVehicleCategories (a list, for example ["SEDAN", "MINIVAN"]), requireInstantConfirmation to receive only quotes that are confirmed instantly, currencyCode for prices in another currency, and discountCode. An invalid discount code is ignored; the quotes are then returned without discount.
  • source: an optional label for where in your platform the request came from.
  • partnerId: only if your key gives access to more than one partner account.

Deprecated field

limitToVehicleCategory (a single value) is deprecated. Use limitToVehicleCategories. If you send both, the list wins.

Step 2: Choose a quote

Show the traveller one option per quote. For each, use:

FieldUse
vehicleCategory, vehicleModels, vehicleImageUrlWhat kind of car to expect
passengerCapacity, luggageCapacityHow many people and bags fit
price, currencyCodeThe price; see also vat, commission and the discount fields
pricePerPassengertrue for shared vehicles, which are priced per passenger
availableTravelAddonsExtras the traveller can book, each with its own id, price and maxAllowed
instantConfirmationWhether the booking is confirmed straight away
freeCancellationUntilUntil when the journey can be cancelled free of charge
expiresUntil when you can book this quote

Keep the quote id and, for each add-on the traveller picks, the add-on id. Add-on ids belong to one quote: in the example both quotes offer meet and greet, each with a different id. You send these ids when you create the booking.

An empty quotes list is a normal answer, not an error: no vehicle is available for this route, time and party, for example because the pickup is too soon. Tell the traveller that no transfer is available, or try another time.

Step 3: Request quotes for the return journey

A return trip is two journeys in one booking, and each journey needs its own quote. Send a second quote request with the origin and destination swapped, the same passengers and luggage, and the pickup time of the return:

POST/quotesReference
Sign in to fill in your staging key. Sign in
curl --request POST \  --url 'https://warpdrive.staging.transferz.com/partners/quotes' \  --header 'Accept: application/json' \  --header 'Content-Type: application/json' \  --header 'X-API-Key: YOUR_STAGING_API_KEY' \  --data '{  "origin": {    "address": {      "addressSearchPhrase": "Herengracht 182, Amsterdam",      "countryCode": "NL"    }  },  "destination": {    "iataCode": "AMS"  },  "pickupDateTime": "2026-12-08T07:30:00",  "adultPassengers": 2,  "checkedLuggage": 2,  "carryOnLuggage": 1,  "currencyCode": "EUR"}'
Response 200
{  "id": 905513,  "quotes": [    {      "id": 7731301,      "vehicleCategory": "SEDAN",      "passengerCapacity": 3,      "luggageCapacity": 3,      "price": 57,      "currencyCode": "EUR",      "expires": "2026-11-20T10:46:00",      "availableTravelAddons": [],      "freeCancellationUntil": "2026-12-07T07:30:00",      "instantConfirmation": true,      "pricePerPassenger": false    }  ]}

Book both quote ids together in one booking. The outbound and the return journey then share one booking code.

Look up the traveller's flight

Storing the flight number with the booking lets Transferz track the flight. Use these calls to let the traveller pick their flight, or to check a flight number they typed.

Search flights lists the flights between two airports on a date. Give an arrivalDate (local to the arrival airport) or a departureDate (local to the departure airport), or both:

GET/flights/searchReference
Sign in to fill in your staging key. Sign in
curl --request GET \  --url 'https://warpdrive.staging.transferz.com/partners/flights/search?departureAirportIataCode=LHR&arrivalAirportIataCode=AMS&arrivalDate=2026-12-01' \  --header 'Accept: application/json' \  --header 'X-API-Key: YOUR_STAGING_API_KEY'
Response 200
[  {    "flightDesignators": [      { "airlineCode": "TZ", "flightNumber": "1234", "primary": true, "airlineName": "Example Air" }    ],    "scheduledDepartureTimeLocal": "2026-12-01T11:15:00",    "departureAirportIataCode": "LHR",    "scheduledArrivalTimeLocal": "2026-12-01T13:40:00",    "arrivalAirportIataCode": "AMS",    "departureAirportCountryCode": "GB",    "arrivalAirportCountryCode": "NL"  }]

Add airlineIataCode, for example KL, to narrow the list. An empty list means no flights were found.

Resolve a flight checks one flight number. Send flightDesignator in IATA format (such as TZ1234) with both the departureDate and the arrivalDate (each local to its airport); all three are required. The response is one flight in the same format as above, or 404 when no such flight exists on those dates.

GET/flights/resolveReference
Sign in to fill in your staging key. Sign in
curl --request GET \  --url 'https://warpdrive.staging.transferz.com/partners/flights/resolve?flightDesignator=TZ1234&departureDate=2026-12-01&arrivalDate=2026-12-01' \  --header 'Accept: application/json' \  --header 'X-API-Key: YOUR_STAGING_API_KEY'
Response 200
{  "flightDesignators": [    { "airlineCode": "TZ", "flightNumber": "1234", "primary": true, "airlineName": "Example Air" }  ],  "scheduledDepartureTimeLocal": "2026-12-01T11:15:00",  "departureAirportIataCode": "LHR",  "scheduledArrivalTimeLocal": "2026-12-01T13:40:00",  "arrivalAirportIataCode": "AMS",  "departureAirportCountryCode": "GB",  "arrivalAirportCountryCode": "NL"}

Use scheduledArrivalTimeLocal to suggest a pickup time, and send the flight number as traveller.flightNumber when you create the booking.

Errors

ProblemCauseWhat to do
400 with NO_HUB_SELECTEDNeither location is a hub.Make the origin or the destination an airport, port or station.
400 with LOCATION_NOT_FOUNDA location could not be resolved; field says which.Send a fuller address with countryCode, coordinates or an IATA code.
400 with ORIGIN_AND_DESTINATION_SAMEBoth locations resolve to the same place.Send two different locations.
400 with NO_VEHICLE_CATEGORIES_AVAILABLENone of the categories in your filter is enabled for your account.Remove the filter, or ask Transferz which categories you have.
400 with CURRENCY_CONVERSION_ERRORcurrencyCode is not supported.Use a supported ISO 4217 code, or leave it out.
400 with a field, such as pickupDateTimeA required field is missing or invalid.Send the field. See validation errors.
200 with an empty quotes listNo vehicle is available.Show that no transfer is available, or try another time.
400 from Search flightsNeither arrivalDate nor departureDate was given.Send at least one of the two dates.
404 from Resolve a flightNo flight with that number on that date.Ask the traveller to check the flight number and date.

Next steps

Was this helpful?