Request quotes
/quotesAuth: X-API-Key headerhttps://warpdrive.staging.transferz.com/partners
Retrieves a set of quotes for the provided input parameters
The first call of every booking. Send where and when the traveller needs to be picked up and how many people and bags travel, and you get one quote per available vehicle category, each with its price, capacity, add-ons and free cancellation deadline.
One of origin or destination must be a hub (an airport, port or station). Locations can be given as an IATA code, an address phrase (add countryCode for better results), coordinates or another supported id. A quote is valid until its expires time; book it with Create booking before then.
No vehicles available
When nothing can be offered (for example the pickup is too soon or no fare is configured) the call still succeeds with an empty quotes list. Show the traveller that no transfer is available rather than an error.
Filtering vehicles
Use limitToVehicleCategories to only receive, for example, SEDAN and MINIVAN quotes. limitToVehicleCategory is deprecated.
Guides: How a booking works, Request quotes, Suggest a pickup time
Headers
Request body
application/json · required
Only return quotes for these vehicle categories.
Unique items
SEDAN- Standard car for up to 3 passengers with luggage.
STATIONWAGON- Estate car with extra luggage space.
SUV- Sport utility vehicle.
MINIVAN- People carrier for up to 6–7 passengers.
BUSINESS_LIMOUSINE- Deprecated business category; use BUSINESS_SEDAN.
BUSINESS_SEDAN- Business-class sedan.
Responses
Errors this endpoint can return
- 400, failedNULL_VALUE
When: pickupDateTime, origin or destination is missing.
What to do: Send the field named in
field. Required fields are marked in the reference. - 400, failedLOCATION_NOT_FOUND
When: The destination address phrase could not be resolved.
What to do: Send a more complete address phrase with a countryCode, coordinates, or an IATA code for airports.
- 400, failedNO_HUB_SELECTED
When: Neither the origin nor the destination is a hub.
What to do: Make the origin or the destination a hub, for example
{"iataCode":"AMS"}. - 400, failedORIGIN_AND_DESTINATION_SAME
When: Origin and destination resolve to the same location.
What to do: Send two different locations.
- 400, failedCURRENCY_CONVERSION_ERROR
When: currencyCode is not supported.
What to do: Use a supported ISO 4217 code such as EUR, or leave currencyCode out to get your account currency.