Get Booking Details

curl "$UNIFYSTAYS_BASE_URL/hotels/book/ubk_eGQ0dW9uV1Vi/details" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en"

{
  "success": true,
  "message": "Booking details retrieved.",
  "data": {
    "booking_id": "ubk_eGQ0dW9uV1Vi",
    "status": "CONFIRMED",
    "is_terminal": true,
    "hotel": {
      "hotel_id": "13553916",
      "hotel_name": "Ramada Plaza by Wyndham Dubai Deira",
      "address": "Corner Of Abu Baker Al Siddique Street",
      "city": "Dubai",
      "state": "Dubai",
      "country": "United Arab Emirates",
      "postal_code": "00000",
      "phone": "+971 4 XXX XXXX",
      "email": "info@ramada.com",
      "stars": 4,
      "latitude": 25.2698,
      "longitude": 55.3095,
      "chain": "Wyndham",
      "hotel_type": "Hotel",
      "main_image_url": "https://cdn.unifystays.com/hotels/13553916/main.jpg",
      "checkin_policy": {}
    },
    "stay": {
      "check_in": "2026-05-26",
      "check_out": "2026-05-28",
      "nights": 2,
      "rooms_count": 1,
      "guests_count": 2,
      "adults_count": 2,
      "children_count": 0
    },
    "rooms": [
      {
        "room_ref": "1",
        "unifystays_room_id": "1321374576",
        "guests": [
          {
            "title": "Mr",
            "first_name": "Shubham",
            "last_name": "Gupta",
            "type": "Adult",
            "pan": "AAACA1111A",
            "passport": "P1234567"
          }
        ]
      }
    ],
    "pricing": {
      "total_payable_now": 604577,
      "currency": "INR"
    },
    "provider": {
      "code": "TRIPJACK",
      "booking_id": "TJ202487947162",
      "provider_hotel_id": "hotel_h_13553916",
      "raw_status": "SUCCESS",
      "message": {},
      "booking_code": "BC_abc123xyz",
      "hotel_confirmation_number": "HCN-482910",
      "hotel_confirmation_status": "Confirmed",
      "hotel_confirmation_note": {},
      "hotel_contact_phone": {},
      "hotel_contact_name": {},
      "cancellation_charge": 29030,
      "cancellation_currency": "AED",
      "post_booking_cancellation_policy": {}
    },
    "polling": {
      "next_poll_after_ms": 5000,
      "next_poll_at": "2026-04-15T12:12:16.000Z",
      "poll_deadline_at": "2026-04-15T12:15:11.000Z",
      "last_polled_at": "2026-04-15T12:12:14.000Z"
    },
    "timeline": [
      {
        "event_type": "BOOKING_CREATED",
        "created_at": "2026-04-15T12:12:11.000Z",
        "from_status": null,
        "to_status": "PROCESSING",
        "message": {},
        "event_payload": {}
      }
    ],
    "attempts": [
      {
        "attempt_type": "DISPATCH",
        "provider_code": "TRIPJACK",
        "success": true,
        "created_at": "2026-04-15T12:12:11.000Z",
        "raw_status": {},
        "message": {},
        "started_at": "2026-04-15T12:12:11.000Z",
        "ended_at": "2026-04-15T12:12:14.120Z",
        "duration_ms": 3120
      }
    ],
    "created_at": "2026-04-15T12:12:11.000Z",
    "updated_at": "2026-04-15T12:12:11.000Z",
    "total_payable_now": 604577,
    "metadata": {},
    "failure_code": {},
    "failure_message": {},
    "completed_at": "2026-04-15T12:15:11.000Z",
    "next_poll_after_ms": {}
  }
}

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"

{
  "success": true,
  "message": "Booking details retrieved.",
  "data": {
    "booking_id": "ubk_eGQ0dW9uV1Vi",
    "status": "CONFIRMED",
    "is_terminal": true,
    "hotel": {
      "hotel_id": "13553916",
      "hotel_name": "Ramada Plaza by Wyndham Dubai Deira",
      "address": "Corner Of Abu Baker Al Siddique Street",
      "city": "Dubai",
      "state": "Dubai",
      "country": "United Arab Emirates",
      "postal_code": "00000",
      "phone": "+971 4 XXX XXXX",
      "email": "info@ramada.com",
      "stars": 4,
      "latitude": 25.2698,
      "longitude": 55.3095,
      "chain": "Wyndham",
      "hotel_type": "Hotel",
      "main_image_url": "https://cdn.unifystays.com/hotels/13553916/main.jpg",
      "checkin_policy": {}
    },
    "stay": {
      "check_in": "2026-05-26",
      "check_out": "2026-05-28",
      "nights": 2,
      "rooms_count": 1,
      "guests_count": 2,
      "adults_count": 2,
      "children_count": 0
    },
    "rooms": [
      {
        "room_ref": "1",
        "unifystays_room_id": "1321374576",
        "guests": [
          {
            "title": "Mr",
            "first_name": "Shubham",
            "last_name": "Gupta",
            "type": "Adult",
            "pan": "AAACA1111A",
            "passport": "P1234567"
          }
        ]
      }
    ],
    "pricing": {
      "total_payable_now": 604577,
      "currency": "INR"
    },
    "provider": {
      "code": "TRIPJACK",
      "booking_id": "TJ202487947162",
      "provider_hotel_id": "hotel_h_13553916",
      "raw_status": "SUCCESS",
      "message": {},
      "booking_code": "BC_abc123xyz",
      "hotel_confirmation_number": "HCN-482910",
      "hotel_confirmation_status": "Confirmed",
      "hotel_confirmation_note": {},
      "hotel_contact_phone": {},
      "hotel_contact_name": {},
      "cancellation_charge": 29030,
      "cancellation_currency": "AED",
      "post_booking_cancellation_policy": {}
    },
    "polling": {
      "next_poll_after_ms": 5000,
      "next_poll_at": "2026-04-15T12:12:16.000Z",
      "poll_deadline_at": "2026-04-15T12:15:11.000Z",
      "last_polled_at": "2026-04-15T12:12:14.000Z"
    },
    "timeline": [
      {
        "event_type": "BOOKING_CREATED",
        "created_at": "2026-04-15T12:12:11.000Z",
        "from_status": null,
        "to_status": "PROCESSING",
        "message": {},
        "event_payload": {}
      }
    ],
    "attempts": [
      {
        "attempt_type": "DISPATCH",
        "provider_code": "TRIPJACK",
        "success": true,
        "created_at": "2026-04-15T12:12:11.000Z",
        "raw_status": {},
        "message": {},
        "started_at": "2026-04-15T12:12:11.000Z",
        "ended_at": "2026-04-15T12:12:14.120Z",
        "duration_ms": 3120
      }
    ],
    "created_at": "2026-04-15T12:12:11.000Z",
    "updated_at": "2026-04-15T12:12:11.000Z",
    "total_payable_now": 604577,
    "metadata": {},
    "failure_code": {},
    "failure_message": {},
    "completed_at": "2026-04-15T12:15:11.000Z",
    "next_poll_after_ms": {}
  }
}

Use this endpoint when your application needs the complete booking record: itinerary pages, confirmation emails, support tools, customer history, and finance reconciliation.

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 status and is_terminal.
Hotel information and stay dates.
Rooms, guests, pricing, cancellation information, and supplier details.
Polling information, timeline events, booking attempts, failure fields, and timestamps.

For polling an in-progress request, prefer the lighter Get Booking Status endpoint and fetch this detail record when your UI needs itinerary content.

Booking details can contain guest personal data and supplier confirmation information. Limit access to trusted backend services and authorized support users.

The OpenAPI section below provides the complete booking detail schema.

Authorizations

x-api-key

string

header

required

Environment-specific API key created in the Unifystays portal

Headers

Path Parameters

booking_id

string

required

Example:

"ubk_eGQ0dW9uV1Vi"

Response

success

boolean

required

Example:

true

message

string

required

Example:

"Booking details retrieved."

data

object

required

Show child attributes

⌘I

Overview

Destination & master data

Search & hotels

Bookings

Request Example

Use the Detail Record

Authorizations

Headers

Path Parameters

Response

​Request Example

​Use the Detail Record

Authorizations

Headers

Path Parameters

Response

Request Example

Use the Detail Record