Request quotes
Request quotes for a transfer, including return trips and flight lookup.
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:
/quotesReferencecurl --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"}'{ "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:
originanddestination(required). One of them must be a hub: an airport, port or station. Give each location in one way: aniataCodefor an airport, anaddresswith anaddressSearchPhrase(addcountryCodefor better matches), acoordinate, or an id such asgooglePlaceId,giataIdortransferzLocationId. The response shows how each location was resolved; checkresolvedAddressbefore 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,checkedLuggageandcarryOnLuggage. Only vehicles with room for them are quoted. - Optional filters:
limitToVehicleCategories(a list, for example["SEDAN", "MINIVAN"]),requireInstantConfirmationto receive only quotes that are confirmed instantly,currencyCodefor prices in another currency, anddiscountCode. 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:
| Field | Use |
|---|---|
vehicleCategory, vehicleModels, vehicleImageUrl | What kind of car to expect |
passengerCapacity, luggageCapacity | How many people and bags fit |
price, currencyCode | The price; see also vat, commission and the discount fields |
pricePerPassenger | true for shared vehicles, which are priced per passenger |
availableTravelAddons | Extras the traveller can book, each with its own id, price and maxAllowed |
instantConfirmation | Whether the booking is confirmed straight away |
freeCancellationUntil | Until when the journey can be cancelled free of charge |
expires | Until 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:
/quotesReferencecurl --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"}'{ "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:
/flights/searchReferencecurl --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'[ { "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.
/flights/resolveReferencecurl --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'{ "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
| Problem | Cause | What to do |
|---|---|---|
400 with NO_HUB_SELECTED | Neither location is a hub. | Make the origin or the destination an airport, port or station. |
400 with LOCATION_NOT_FOUND | A location could not be resolved; field says which. | Send a fuller address with countryCode, coordinates or an IATA code. |
400 with ORIGIN_AND_DESTINATION_SAME | Both locations resolve to the same place. | Send two different locations. |
400 with NO_VEHICLE_CATEGORIES_AVAILABLE | None 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_ERROR | currencyCode is not supported. | Use a supported ISO 4217 code, or leave it out. |
400 with a field, such as pickupDateTime | A required field is missing or invalid. | Send the field. See validation errors. |
200 with an empty quotes list | No vehicle is available. | Show that no transfer is available, or try another time. |
400 from Search flights | Neither arrivalDate nor departureDate was given. | Send at least one of the two dates. |
404 from Resolve a flight | No flight with that number on that date. | Ask the traveller to check the flight number and date. |
Next steps
- Suggest a pickup time from the flight.
- Create a booking with the chosen quote.
Related
Walk-through