Sign in
hotel-bookings

Book

Take the booking. Safe to call again after any failure.

A 409 book_indeterminate does NOT mean the booking failed — it means we could not establish whether it succeeded. The correct client response is to call this endpoint again; the reference is fixed, so a retry resolves into the existing booking rather than creating a second one.

post/hotel-bookings/{booking_id}/book

Path parameters

booking_idstring uuid required

Request body

transaction_idstring nullable
metadataobject nullable

Response

Successful Response

booking_idstring uuid required
statusstring required
provider_statusstring nullable required
provider_booking_idstring nullable required
hotel_confirmation_codestring nullable required
hotel_idstring required
hotel_namestring nullable required
checkinstring date required
checkoutstring date required
currencystring required
all_in_totalnumber nullable required
booked_totalnumber nullable required
cancellation_feenumber nullable required
refund_amountnumber nullable required
refundable_tagstring nullable required
cancellation_policyobject nullable required
rooms_pricedinteger nullable required
trip_idstring uuid nullable required
stay_tool_call_idstring nullable required
sandboxboolean required
payment_statusstring nullable required
payment_modelstring nullable required
payment_secretstring nullable required
prebook_idstring nullable required
booking_intent_idstring nullable required

Changes

No recorded changes to this endpoint across all 22 revisions of this API.