Booking HCN Query With Booking ID
The BookingHCNQuery operation allows customers to retrieve the Hotel Confirmation Number for their bookings, which is a booking confirmation number directly from the hotel’s reservation system. The HCN is not available immediately and will be available only for bookings with an arrival date within the next 7 days.
BookingHCNQuery accepts any of the parameters outlined below and returns an array of booking hotel confirmation numbers that are due to arrive within the next 7 days.
HCN Search Parameter
- You can request the HCN using Booking Id.
- You can request the HCN of all bookings without specifying the Booking Id.
BookingHCNQuery Request Syntax
Request Header
POST /BookingHCNQuery
Content-Type: “application/json”
AuthApiKey: <Your API Key>
Accept-Encoding: “gzip,br”
Request Body Schema
| Name | Type | Description |
|---|---|---|
|
BookingId (optional) |
Integer |
If the booking Id is matched, then just the matching booking is returned. |
Response Body Schema
| Name | Type | Description |
|---|---|---|
|
Currency |
String |
The currency code for prices (e.g., “EUR”). All rates will be displayed in the default currency associated with your Stuba account |
|
Message |
String |
Message or status note related to the booking (null if none). |
|
Bookings |
Array of Object |
List of bookings. |
|
Id |
Integer |
Unique identifier for the booking. |
|
HotelBookings |
Array of Object |
List of hotel bookings included in this booking. |
|
ArrivalDate |
Date |
Check-in or arrival date and time at the hotel. (YYYY-MM-DD) |
|
Nights |
Integer |
Number of nights booked for the stay. |
|
Status |
String |
Status of the hotel booking (e.g., “confirmed”). |
|
Rooms |
Array of Object |
List of rooms included in this hotel booking. |
|
Adult |
Array of Object |
List of adult guests in the room. |
|
Id |
Integer |
Unique identifier for the adult guest. |
|
Title |
String |
Title of the adult guest (e.g., “Mr”, “Mrs”). |
|
First |
String |
First name of the adult guest. |
|
Last |
String |
Last name of the adult guest. |
|
HCN |
String |
The Hotel Confirmation number as provided by the property booked |
HAPI Response Samples
Samples
