Create booking
/bookingsAuth: X-API-Key headerhttps://warpdrive.staging.transferz.com/partners
Creates a booking using one or more provided quotes
Books one or more quotes. Each quote becomes a journey with its own traveller details and add-ons; a return trip is one booking with two quotes. partnerReference is your own order reference and is shown in the Transferz back office.
The booking is created with journeys in status NOT_PAID. It is only processed after payment: call one of the pay endpoints next (pay by invoice, a payment link or Stripe Connect).
Add-ons
Book add-ons with the quoteTravelAddonId from the quote's availableTravelAddons, within maxAllowed.
Expired quotes
Quotes expire (see expires). Book promptly after quoting, or request new quotes.
Guides: How a booking works, Create a booking
Headers
Request body
application/json · required
Responses
Created
Errors this endpoint can return
- 400, failedQUOTE_EXPIRED
When: The quote's expiry time has passed.
What to do: Request new quotes and book with a fresh quote id.
- 400, failedNULL_VALUE
When: booker, quotes or partnerReference is missing.
What to do: Send the field named in
field. Required fields are marked in the reference. - 400, failedINVALID_SIZE
When: The booker email is shorter than 6 characters or languageIsoCode is not 2 letters.
What to do: Check the limits in the field description and shorten or complete the value.
- 400, failedQUOTE_CAPACITY_CONSTRAINT
When: More passengers or bags than the quoted vehicle carries.
What to do: Request quotes with the right passenger and luggage counts and choose a vehicle that fits.
When: An add-on amount is above its maxAllowed.
What to do: Stay within maxAllowed (and within combinedSeatBasedAddonCapacity for child seats).