Booking

Recheck, book and read bookings.

📄️Recheck an offer

Confirms that an offer can still be booked and returns its current price and a fresh `offer_token` for book. Call it immediately before book. A provider-side failure answers `200` with `available: false` and `error`. An offer older than 24 hours answers `409 offer_expired`, an offer that can no longer be priced in the search's currency `409 currency_unavailable` (search again); a missing, modified or foreign `offer_token` answers `422 invalid_offer_token`.

📄️Book an offer

Books a rechecked offer. Allow up to 150 seconds. **Idempotent per `internal_reference`**: TransferPlatform records the attempt before calling the provider; re-sending the identical request returns the original booking (`Idempotent-Replayed: true`), and a different request, or one while the first is in progress or `unknown`, answers `409 duplicate_booking` without booking. A declined booking answers `200` with `status: failed`; a provider that did not answer in time `200` with `status: unknown` (re-send the identical request later). `409 offer_expired` / `409 currency_unavailable` / `422 invalid_offer_token` as for recheck.

📄️Get 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`.

📄️Get booking details (deprecated alias)

Deprecated alias of `POST /v1/transfer/booking-details`: same request and response.