curl "$UNIFYSTAYS_BASE_URL/hotels/book/ubk_eGQ0dW9uV1Vi/details" \
-H "x-api-key: $UNIFYSTAYS_API_KEY" \
-H "language: en"
{
"contract_version": "1",
"success": true,
"message": "<string>",
"data": {
"booking_id": "<string>",
"accepted_offer_id": "<string>",
"booked_offer": {
"offer_id": "off_01J...",
"revision": 1,
"offer_family_id": "<string>",
"supersedes_offer_id": "<string>",
"quote_context": {
"hotel": {
"id": "<string>",
"name": "<string>",
"address": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"postal_code": "<string>",
"latitude": 123,
"longitude": 123,
"timezone": "<string>"
},
"check_in": "<string>",
"check_out": "<string>",
"nights": 123,
"rooms": [
{
"adults": 123,
"child_ages": [
123
]
}
],
"residency": "<string>",
"nationality": "<string>",
"language": "<string>"
},
"provider_code": "TBO",
"room_combination": {
"normalized_type": "SINGLE_ROOM",
"supplier_code": "<string>",
"supplier_name": "<string>"
},
"rate_plan": {
"normalized_type": "PUBLIC",
"supplier_code": "<string>",
"supplier_name": "<string>",
"qualification": "<string>",
"is_package": true,
"is_fenced": true
},
"rooms": [
{
"room_allocation_id": "ra_2c1fb39ed54742f28d95bd8bc5f4375d",
"provider_room": {
"provider_code": "TRIPJACK",
"provider_hotel_id": "100000249368",
"id": "10024615989",
"name": "Aloft Studio, King",
"supplier_name": "<string>",
"description": "<string>",
"detail_status": "NONE",
"room_type": {
"normalized_code": "SUPERIOR",
"supplier_code": "<string>",
"supplier_name": "<string>"
},
"room_category": {
"normalized_code": "SUPERIOR",
"supplier_code": "<string>",
"supplier_name": "<string>"
},
"size": {
"value": 123,
"unit": "sqm"
},
"amenities": [
{
"id": "2403",
"normalized_code": "FREE_WIFI",
"supplier_code": "2403",
"name": "Free WiFi"
}
],
"images": [
{
"url": "<string>",
"caption": "<string>",
"is_primary": true
}
],
"bed_configurations": [
{
"id": "<string>",
"bed_count": 1,
"bedroom_count": 1,
"beds": [
{
"type": "King",
"normalized_type": "SINGLE",
"supplier_type": "<string>",
"quantity": 1
}
],
"bed_type_guaranteed": true,
"selected": true
}
],
"occupancy": {
"max_allowed": {
"total": 3,
"adults": 3,
"children": 2,
"infants": 123
}
},
"bathroom": {
"type": "PRIVATE",
"count": 123
},
"views": [
{
"normalized_code": "CITY",
"supplier_code": "<string>",
"name": "<string>"
}
],
"features": {
"balcony": true,
"smoking": "SMOKING",
"accessible": true,
"club_access": true,
"connecting_room": true
},
"extra_bed": {
"available": true,
"included": true,
"charge_applicable": true
},
"child_bed": {
"available": true,
"included": true,
"charge_applicable": true
}
},
"mapping_status": "MAPPED",
"mapping_details": {
"source": "MANUAL",
"confidence": 0.93,
"algorithm_version": "ROOM_RULES_V5",
"reason_codes": [
"GLOBAL_CATALOGUE_ASSIGNMENT",
"ASSIGNMENT_STABLE",
"BED_EXACT"
]
},
"unifystays_room": {
"room_id": "1001",
"room_name": "Deluxe King Room",
"description": "Spacious room with king bed and city view.",
"room_size_value": 32,
"room_size_unit": "sqm",
"bed_relation": "King Bed",
"max_adults": 2,
"max_children": 1,
"max_occupancy": 3,
"bed_types": [
{
"id": 123,
"quantity": 123,
"bed_type": "<string>",
"bed_size": "<string>"
}
],
"amenities": [
{
"amenities_id": 123,
"name": "<string>",
"sort": 123
}
],
"photos": [
{
"url": "<string>",
"main_photo": true
}
],
"views": [
{
"id": 123,
"view": "<string>"
}
]
},
"occupancy": {
"adults": 2,
"child_ages": [
7
]
},
"meal_plan": {
"code": "BB",
"supplier_code": "breakfast",
"supplier_name": "Breakfast",
"label": "Bed & Breakfast",
"is_breakfast_included": true,
"is_child_meal_included": true
},
"inclusions": [
{
"code": "free_wifi",
"label": "Free WiFi"
}
]
}
],
"lifecycle": {
"stage": "ROOMS",
"quoted_at": "<string>",
"expires_at": "<string>",
"prebook_required": true,
"price_guaranteed": true,
"availability": "AVAILABLE",
"rooms_remaining": {},
"on_request": true,
"available_booking_modes": [
"INSTANT"
],
"hold_allowed": true,
"hold_deadline": {
"local_datetime": "2026-05-18T23:59:59",
"timezone": "UTC",
"utc_datetime": "2026-05-18T23:59:59.000Z"
},
"post_booking_actions": [
"STATUS"
]
},
"pricing": {
"price_basis": "NET",
"breakdown_status": "COMPLETE",
"native_ledger": {
"primary_currency": "USD",
"totals": [
{
"currency": "USD",
"currency_exponent": 2,
"payable_to_supplier": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"payable_at_property": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
}
}
],
"lines": [
{
"category": "room_rate",
"code": "city_tax",
"normalized_code": "CITY_TAX",
"description": "City tax",
"amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"collection_location": "SUPPLIER",
"included_in_quoted_total": false,
"scope": {
"basis": "PER_STAY",
"room_allocation_id": "<string>",
"guest_type": "ADULT",
"quantity": 123
},
"mandatory": true,
"source_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"is_estimated": true
}
]
},
"usd_ledger": {
"primary_currency": "USD",
"totals": [
{
"currency": "USD",
"currency_exponent": 2,
"payable_to_supplier": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"payable_at_property": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
}
}
],
"lines": [
{
"category": "room_rate",
"code": "city_tax",
"normalized_code": "CITY_TAX",
"description": "City tax",
"amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"collection_location": "SUPPLIER",
"included_in_quoted_total": false,
"scope": {
"basis": "PER_STAY",
"room_allocation_id": "<string>",
"guest_type": "ADULT",
"quantity": 123
},
"mandatory": true,
"source_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"is_estimated": true
}
]
},
"conversion": {
"status": "AVAILABLE",
"missing_currencies": [
"<string>"
],
"rates": [
{
"base_currency": "AED",
"quote_currency": "USD",
"rate": 0.272294,
"rate_updated_at": "<string>"
}
]
}
},
"payment": {
"settlement_channel": "SUPPLIER_ACCOUNT",
"payer": "AGENCY",
"supplier_payment_type": "<string>",
"payable_at": "SUPPLIER",
"collection_timing": "AT_BOOKING",
"requires_card_data": true,
"requires_cvc": true,
"requires_vcc": true,
"security_deposit": {
"amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"refundable": true
}
},
"commercial": {
"supplier_charge_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"display_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"gross_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"net_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"commission_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"agent_reward": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"recommended_selling_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"minimum_selling_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"original_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"discount_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"vat": {
"included": true,
"applied": true,
"amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"rate": 123
}
},
"booking_requirements": [
{
"requirement_id": "br_first_name_all_guests_2",
"code": "FIRST_NAME",
"label": "First name",
"value_type": "TEXT",
"scope": "LEAD_GUEST",
"room_allocation_ids": [
"<string>"
],
"required": true,
"allowed_values": [
"<string>"
],
"description": "<string>",
"constraints": {
"min_length": 123,
"max_length": 123,
"pattern": "<string>",
"min_age": 123,
"max_age": 123
}
}
],
"cancellation": {
"refundability": "REFUNDABLE",
"policy_stage": "INDICATIVE",
"free_cancellation_until": {
"local_datetime": "2026-05-18T23:59:59",
"timezone": "UTC",
"utc_datetime": "2026-05-18T23:59:59.000Z"
},
"policy_text": "<string>",
"penalties": [
{
"from": {
"local_datetime": "2026-05-18T23:59:59",
"timezone": "UTC",
"utc_datetime": "2026-05-18T23:59:59.000Z"
},
"to": {
"local_datetime": "2026-05-18T23:59:59",
"timezone": "UTC",
"utc_datetime": "2026-05-18T23:59:59.000Z"
},
"charge_basis": "FIXED_AMOUNT",
"percentage": 123,
"number_of_nights": 123,
"native_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"usd_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"conversion_status": "AVAILABLE",
"description": "<string>",
"calculation_basis": "TOTAL",
"scope": {
"basis": "PER_STAY",
"room_allocation_id": "<string>",
"guest_type": "ADULT",
"quantity": 123
}
}
],
"no_show": {
"trigger": "NO_SHOW",
"applies_from_local_time": "18:00:00",
"penalty": {
"charge_basis": "FIXED_AMOUNT",
"native_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"usd_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"conversion_status": "AVAILABLE",
"calculation_basis": "SUPPLIER_DEFINED",
"scope": {
"basis": "PER_STAY",
"room_allocation_id": "<string>",
"guest_type": "ADULT",
"quantity": 123
}
}
}
},
"nightly_prices": [
{
"date": "<string>",
"room_allocation_id": "<string>",
"amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"scope": "OFFER",
"component": "ROOM_RATE"
}
],
"promotions": [
{
"code": "<string>",
"title": "<string>",
"description": "<string>"
}
],
"benefits": [
{
"code": "free_wifi",
"label": "Free WiFi"
}
],
"notices": [
{
"code": "<string>",
"severity": "INFO",
"scope": "OFFER",
"text": "<string>",
"must_display": true
}
],
"supplier_terms_and_conditions": {
"type": "SUPPLIER_TERMS_AND_CONDITIONS",
"format": "PLAIN_TEXT",
"text": "<string>"
}
},
"guests": [
{
"guest_id": "<string>",
"guest_type": "ADULT",
"is_lead_guest": true,
"room_allocation_id": "<string>",
"answers": [
{
"requirement_id": "<string>",
"code": "<string>",
"value": "<string>"
}
]
}
],
"references": {
"booking_id": "<string>",
"client_reference": "<string>",
"supplier_booking_id": "<string>",
"supplier_booking_code": "<string>",
"hotel_confirmation_number": "<string>"
},
"lifecycle": {
"status": "AWAITING_REVIEW",
"is_terminal": true,
"created_at": "<string>",
"updated_at": "<string>",
"completed_at": "<string>",
"processing_reason": "<string>",
"action_required": true,
"available_actions": [
"<string>"
],
"hold_deadline_at": "<string>",
"review_expires_at": "<string>"
},
"voucher": {
"available": true,
"url": "<string>",
"hotel_confirmation_number": "<string>",
"note": "<string>"
},
"current_cancellation": {
"refundability": "REFUNDABLE",
"policy_stage": "INDICATIVE",
"free_cancellation_until": {
"local_datetime": "2026-05-18T23:59:59",
"timezone": "UTC",
"utc_datetime": "2026-05-18T23:59:59.000Z"
},
"policy_text": "<string>",
"penalties": [
{
"from": {
"local_datetime": "2026-05-18T23:59:59",
"timezone": "UTC",
"utc_datetime": "2026-05-18T23:59:59.000Z"
},
"to": {
"local_datetime": "2026-05-18T23:59:59",
"timezone": "UTC",
"utc_datetime": "2026-05-18T23:59:59.000Z"
},
"charge_basis": "FIXED_AMOUNT",
"percentage": 123,
"number_of_nights": 123,
"native_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"usd_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"conversion_status": "AVAILABLE",
"description": "<string>",
"calculation_basis": "TOTAL",
"scope": {
"basis": "PER_STAY",
"room_allocation_id": "<string>",
"guest_type": "ADULT",
"quantity": 123
}
}
],
"no_show": {
"trigger": "NO_SHOW",
"applies_from_local_time": "18:00:00",
"penalty": {
"charge_basis": "FIXED_AMOUNT",
"native_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"usd_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"conversion_status": "AVAILABLE",
"calculation_basis": "SUPPLIER_DEFINED",
"scope": {
"basis": "PER_STAY",
"room_allocation_id": "<string>",
"guest_type": "ADULT",
"quantity": 123
}
}
}
},
"cancellation_outcome": {
"status": "NOT_REQUESTED",
"charge": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
}
},
"failure": {
"code": "<string>",
"message": "<string>"
},
"confirmed_details": {
"supplier_status": "<string>",
"supplier_created_at": "<string>",
"supplier_modified_at": "<string>",
"check_in": "<string>",
"check_out": "<string>",
"is_cancellable": true,
"rooms": [
{
"supplier_room_id": "<string>",
"supplier_room_name": "<string>",
"meal_plan_name": "<string>",
"bed_configuration": "<string>",
"adults": 123,
"children": 123,
"quantity": 123
}
],
"pricing": {
"payable_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"selling_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"refunded_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"vat_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
}
},
"payment": {
"supplier_payment_type": "<string>",
"payment_by": "<string>",
"paid_at": "<string>",
"payment_due": "<string>",
"payment_pending": "<string>",
"invoice_id": "<string>"
},
"voucher_comment": "<string>"
}
}
}Bookings
Get Booking Details
Retrieve the complete itinerary, rooms, guests, pricing, supplier information, and booking timeline.
GET
/
hotels
/
book
/
{booking_id}
/
details
curl "$UNIFYSTAYS_BASE_URL/hotels/book/ubk_eGQ0dW9uV1Vi/details" \
-H "x-api-key: $UNIFYSTAYS_API_KEY" \
-H "language: en"
{
"contract_version": "1",
"success": true,
"message": "<string>",
"data": {
"booking_id": "<string>",
"accepted_offer_id": "<string>",
"booked_offer": {
"offer_id": "off_01J...",
"revision": 1,
"offer_family_id": "<string>",
"supersedes_offer_id": "<string>",
"quote_context": {
"hotel": {
"id": "<string>",
"name": "<string>",
"address": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"postal_code": "<string>",
"latitude": 123,
"longitude": 123,
"timezone": "<string>"
},
"check_in": "<string>",
"check_out": "<string>",
"nights": 123,
"rooms": [
{
"adults": 123,
"child_ages": [
123
]
}
],
"residency": "<string>",
"nationality": "<string>",
"language": "<string>"
},
"provider_code": "TBO",
"room_combination": {
"normalized_type": "SINGLE_ROOM",
"supplier_code": "<string>",
"supplier_name": "<string>"
},
"rate_plan": {
"normalized_type": "PUBLIC",
"supplier_code": "<string>",
"supplier_name": "<string>",
"qualification": "<string>",
"is_package": true,
"is_fenced": true
},
"rooms": [
{
"room_allocation_id": "ra_2c1fb39ed54742f28d95bd8bc5f4375d",
"provider_room": {
"provider_code": "TRIPJACK",
"provider_hotel_id": "100000249368",
"id": "10024615989",
"name": "Aloft Studio, King",
"supplier_name": "<string>",
"description": "<string>",
"detail_status": "NONE",
"room_type": {
"normalized_code": "SUPERIOR",
"supplier_code": "<string>",
"supplier_name": "<string>"
},
"room_category": {
"normalized_code": "SUPERIOR",
"supplier_code": "<string>",
"supplier_name": "<string>"
},
"size": {
"value": 123,
"unit": "sqm"
},
"amenities": [
{
"id": "2403",
"normalized_code": "FREE_WIFI",
"supplier_code": "2403",
"name": "Free WiFi"
}
],
"images": [
{
"url": "<string>",
"caption": "<string>",
"is_primary": true
}
],
"bed_configurations": [
{
"id": "<string>",
"bed_count": 1,
"bedroom_count": 1,
"beds": [
{
"type": "King",
"normalized_type": "SINGLE",
"supplier_type": "<string>",
"quantity": 1
}
],
"bed_type_guaranteed": true,
"selected": true
}
],
"occupancy": {
"max_allowed": {
"total": 3,
"adults": 3,
"children": 2,
"infants": 123
}
},
"bathroom": {
"type": "PRIVATE",
"count": 123
},
"views": [
{
"normalized_code": "CITY",
"supplier_code": "<string>",
"name": "<string>"
}
],
"features": {
"balcony": true,
"smoking": "SMOKING",
"accessible": true,
"club_access": true,
"connecting_room": true
},
"extra_bed": {
"available": true,
"included": true,
"charge_applicable": true
},
"child_bed": {
"available": true,
"included": true,
"charge_applicable": true
}
},
"mapping_status": "MAPPED",
"mapping_details": {
"source": "MANUAL",
"confidence": 0.93,
"algorithm_version": "ROOM_RULES_V5",
"reason_codes": [
"GLOBAL_CATALOGUE_ASSIGNMENT",
"ASSIGNMENT_STABLE",
"BED_EXACT"
]
},
"unifystays_room": {
"room_id": "1001",
"room_name": "Deluxe King Room",
"description": "Spacious room with king bed and city view.",
"room_size_value": 32,
"room_size_unit": "sqm",
"bed_relation": "King Bed",
"max_adults": 2,
"max_children": 1,
"max_occupancy": 3,
"bed_types": [
{
"id": 123,
"quantity": 123,
"bed_type": "<string>",
"bed_size": "<string>"
}
],
"amenities": [
{
"amenities_id": 123,
"name": "<string>",
"sort": 123
}
],
"photos": [
{
"url": "<string>",
"main_photo": true
}
],
"views": [
{
"id": 123,
"view": "<string>"
}
]
},
"occupancy": {
"adults": 2,
"child_ages": [
7
]
},
"meal_plan": {
"code": "BB",
"supplier_code": "breakfast",
"supplier_name": "Breakfast",
"label": "Bed & Breakfast",
"is_breakfast_included": true,
"is_child_meal_included": true
},
"inclusions": [
{
"code": "free_wifi",
"label": "Free WiFi"
}
]
}
],
"lifecycle": {
"stage": "ROOMS",
"quoted_at": "<string>",
"expires_at": "<string>",
"prebook_required": true,
"price_guaranteed": true,
"availability": "AVAILABLE",
"rooms_remaining": {},
"on_request": true,
"available_booking_modes": [
"INSTANT"
],
"hold_allowed": true,
"hold_deadline": {
"local_datetime": "2026-05-18T23:59:59",
"timezone": "UTC",
"utc_datetime": "2026-05-18T23:59:59.000Z"
},
"post_booking_actions": [
"STATUS"
]
},
"pricing": {
"price_basis": "NET",
"breakdown_status": "COMPLETE",
"native_ledger": {
"primary_currency": "USD",
"totals": [
{
"currency": "USD",
"currency_exponent": 2,
"payable_to_supplier": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"payable_at_property": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
}
}
],
"lines": [
{
"category": "room_rate",
"code": "city_tax",
"normalized_code": "CITY_TAX",
"description": "City tax",
"amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"collection_location": "SUPPLIER",
"included_in_quoted_total": false,
"scope": {
"basis": "PER_STAY",
"room_allocation_id": "<string>",
"guest_type": "ADULT",
"quantity": 123
},
"mandatory": true,
"source_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"is_estimated": true
}
]
},
"usd_ledger": {
"primary_currency": "USD",
"totals": [
{
"currency": "USD",
"currency_exponent": 2,
"payable_to_supplier": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"payable_at_property": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
}
}
],
"lines": [
{
"category": "room_rate",
"code": "city_tax",
"normalized_code": "CITY_TAX",
"description": "City tax",
"amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"collection_location": "SUPPLIER",
"included_in_quoted_total": false,
"scope": {
"basis": "PER_STAY",
"room_allocation_id": "<string>",
"guest_type": "ADULT",
"quantity": 123
},
"mandatory": true,
"source_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"is_estimated": true
}
]
},
"conversion": {
"status": "AVAILABLE",
"missing_currencies": [
"<string>"
],
"rates": [
{
"base_currency": "AED",
"quote_currency": "USD",
"rate": 0.272294,
"rate_updated_at": "<string>"
}
]
}
},
"payment": {
"settlement_channel": "SUPPLIER_ACCOUNT",
"payer": "AGENCY",
"supplier_payment_type": "<string>",
"payable_at": "SUPPLIER",
"collection_timing": "AT_BOOKING",
"requires_card_data": true,
"requires_cvc": true,
"requires_vcc": true,
"security_deposit": {
"amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"refundable": true
}
},
"commercial": {
"supplier_charge_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"display_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"gross_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"net_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"commission_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"agent_reward": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"recommended_selling_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"minimum_selling_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"original_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"discount_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"vat": {
"included": true,
"applied": true,
"amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"rate": 123
}
},
"booking_requirements": [
{
"requirement_id": "br_first_name_all_guests_2",
"code": "FIRST_NAME",
"label": "First name",
"value_type": "TEXT",
"scope": "LEAD_GUEST",
"room_allocation_ids": [
"<string>"
],
"required": true,
"allowed_values": [
"<string>"
],
"description": "<string>",
"constraints": {
"min_length": 123,
"max_length": 123,
"pattern": "<string>",
"min_age": 123,
"max_age": 123
}
}
],
"cancellation": {
"refundability": "REFUNDABLE",
"policy_stage": "INDICATIVE",
"free_cancellation_until": {
"local_datetime": "2026-05-18T23:59:59",
"timezone": "UTC",
"utc_datetime": "2026-05-18T23:59:59.000Z"
},
"policy_text": "<string>",
"penalties": [
{
"from": {
"local_datetime": "2026-05-18T23:59:59",
"timezone": "UTC",
"utc_datetime": "2026-05-18T23:59:59.000Z"
},
"to": {
"local_datetime": "2026-05-18T23:59:59",
"timezone": "UTC",
"utc_datetime": "2026-05-18T23:59:59.000Z"
},
"charge_basis": "FIXED_AMOUNT",
"percentage": 123,
"number_of_nights": 123,
"native_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"usd_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"conversion_status": "AVAILABLE",
"description": "<string>",
"calculation_basis": "TOTAL",
"scope": {
"basis": "PER_STAY",
"room_allocation_id": "<string>",
"guest_type": "ADULT",
"quantity": 123
}
}
],
"no_show": {
"trigger": "NO_SHOW",
"applies_from_local_time": "18:00:00",
"penalty": {
"charge_basis": "FIXED_AMOUNT",
"native_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"usd_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"conversion_status": "AVAILABLE",
"calculation_basis": "SUPPLIER_DEFINED",
"scope": {
"basis": "PER_STAY",
"room_allocation_id": "<string>",
"guest_type": "ADULT",
"quantity": 123
}
}
}
},
"nightly_prices": [
{
"date": "<string>",
"room_allocation_id": "<string>",
"amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"scope": "OFFER",
"component": "ROOM_RATE"
}
],
"promotions": [
{
"code": "<string>",
"title": "<string>",
"description": "<string>"
}
],
"benefits": [
{
"code": "free_wifi",
"label": "Free WiFi"
}
],
"notices": [
{
"code": "<string>",
"severity": "INFO",
"scope": "OFFER",
"text": "<string>",
"must_display": true
}
],
"supplier_terms_and_conditions": {
"type": "SUPPLIER_TERMS_AND_CONDITIONS",
"format": "PLAIN_TEXT",
"text": "<string>"
}
},
"guests": [
{
"guest_id": "<string>",
"guest_type": "ADULT",
"is_lead_guest": true,
"room_allocation_id": "<string>",
"answers": [
{
"requirement_id": "<string>",
"code": "<string>",
"value": "<string>"
}
]
}
],
"references": {
"booking_id": "<string>",
"client_reference": "<string>",
"supplier_booking_id": "<string>",
"supplier_booking_code": "<string>",
"hotel_confirmation_number": "<string>"
},
"lifecycle": {
"status": "AWAITING_REVIEW",
"is_terminal": true,
"created_at": "<string>",
"updated_at": "<string>",
"completed_at": "<string>",
"processing_reason": "<string>",
"action_required": true,
"available_actions": [
"<string>"
],
"hold_deadline_at": "<string>",
"review_expires_at": "<string>"
},
"voucher": {
"available": true,
"url": "<string>",
"hotel_confirmation_number": "<string>",
"note": "<string>"
},
"current_cancellation": {
"refundability": "REFUNDABLE",
"policy_stage": "INDICATIVE",
"free_cancellation_until": {
"local_datetime": "2026-05-18T23:59:59",
"timezone": "UTC",
"utc_datetime": "2026-05-18T23:59:59.000Z"
},
"policy_text": "<string>",
"penalties": [
{
"from": {
"local_datetime": "2026-05-18T23:59:59",
"timezone": "UTC",
"utc_datetime": "2026-05-18T23:59:59.000Z"
},
"to": {
"local_datetime": "2026-05-18T23:59:59",
"timezone": "UTC",
"utc_datetime": "2026-05-18T23:59:59.000Z"
},
"charge_basis": "FIXED_AMOUNT",
"percentage": 123,
"number_of_nights": 123,
"native_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"usd_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"conversion_status": "AVAILABLE",
"description": "<string>",
"calculation_basis": "TOTAL",
"scope": {
"basis": "PER_STAY",
"room_allocation_id": "<string>",
"guest_type": "ADULT",
"quantity": 123
}
}
],
"no_show": {
"trigger": "NO_SHOW",
"applies_from_local_time": "18:00:00",
"penalty": {
"charge_basis": "FIXED_AMOUNT",
"native_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"usd_amount": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"conversion_status": "AVAILABLE",
"calculation_basis": "SUPPLIER_DEFINED",
"scope": {
"basis": "PER_STAY",
"room_allocation_id": "<string>",
"guest_type": "ADULT",
"quantity": 123
}
}
}
},
"cancellation_outcome": {
"status": "NOT_REQUESTED",
"charge": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
}
},
"failure": {
"code": "<string>",
"message": "<string>"
},
"confirmed_details": {
"supplier_status": "<string>",
"supplier_created_at": "<string>",
"supplier_modified_at": "<string>",
"check_in": "<string>",
"check_out": "<string>",
"is_cancellable": true,
"rooms": [
{
"supplier_room_id": "<string>",
"supplier_room_name": "<string>",
"meal_plan_name": "<string>",
"bed_configuration": "<string>",
"adults": 123,
"children": 123,
"quantity": 123
}
],
"pricing": {
"payable_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"selling_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"refunded_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
},
"vat_total": {
"amount_minor": 17700,
"currency": "USD",
"currency_exponent": 2
}
},
"payment": {
"supplier_payment_type": "<string>",
"payment_by": "<string>",
"paid_at": "<string>",
"payment_due": "<string>",
"payment_pending": "<string>",
"invoice_id": "<string>"
},
"voucher_comment": "<string>"
}
}
}Use this endpoint when your application needs the complete booking record:
itinerary pages, confirmation emails, support tools, customer history, and
finance reconciliation.
The OpenAPI section below provides the complete booking detail schema.
Request Example
curl "$UNIFYSTAYS_BASE_URL/hotels/book/ubk_eGQ0dW9uV1Vi/details" \
-H "x-api-key: $UNIFYSTAYS_API_KEY" \
-H "language: en"
Use the Detail Record
The response includes:- Unified
statusandis_terminal. - Hotel information and stay dates.
- Rooms, guests, pricing, cancellation information, and supplier details.
- Polling information, timeline events, booking attempts, failure fields, and timestamps.
Booking details can contain guest personal data and supplier confirmation
information. Limit access to trusted backend services and authorized support
users.
Authorizations
Environment-specific API key created in the Unifystays portal
Headers
Hotel API contract version. Missing defaults to v1.
Available options:
1 Path Parameters
Example:
"ubk_eGQ0dW9uV1Vi"