Get booking details
POST/v1/transfer/booking-details
Returns the booking in one normalised shape for every provider: status, trip, passengers, vehicle, meeting instructions, driver, price and cancellation. Use it for vouchers and status refreshes. Only bookings made with your account can be read (404 otherwise); a modified supplier_reference answers 422 invalid_booking_token.
Guide: Booking details & vouchers.
Request
Responses
- 200
- 401
- 403
- 404
- 413
- 422
- 429
- 500
- 503
OK
Response Headers
Id of this request (yours if you sent a valid one). Quote it to support.
Missing or invalid API key (unauthorized). Header WWW-Authenticate: ApiKey header="X-API-Key".
Response Headers
ApiKey header="X-API-Key"
Provider not enabled for this API key (provider_not_enabled).
Response Headers
Id of this request (yours if you sent a valid one). Quote it to support.
Booking not found for your account (booking_not_found).
Response Headers
Id of this request (yours if you sent a valid one). Quote it to support.
Request body larger than 256 KB (payload_too_large).
Response Headers
Id of this request (yours if you sent a valid one). Quote it to support.
Invalid request body (validation_error), or a missing / modified / foreign token (invalid_booking_token).
Response Headers
Id of this request (yours if you sent a valid one). Quote it to support.
Rate limit exceeded for this API key (rate_limited). Wait Retry-After seconds.
Response Headers
Id of this request (yours if you sent a valid one). Quote it to support.
Seconds to wait before retrying.
Unexpected error (internal_error); no details are returned. Report it with the request_id.
Response Headers
Id of this request (yours if you sent a valid one). Quote it to support.
Authentication or booking records temporarily unavailable (auth_unavailable, service_unavailable). Nothing reached a provider. Retry with backoff.
Response Headers
Id of this request (yours if you sent a valid one). Quote it to support.