Response of Reservation Information
The below represent some different response models for reservations. Please note that multiple reservation child elements of different status element types can be mixed in a single reservation's response element.
Response Model — No Pending New, Modified, Cancelled Reservations
In this case no messages are pending in queue for the provider based on the parameters provided in Step 1.
Sample Success Response
{
"reservations": []
}Response Model — New Reservation Confirmation
Attributes
reservations array (Required)
List of reservation objects.
reservation (Required)
Every reservation is indicated with a 'reservation' element.
booked_at date (Required)
Date when the booking has been made.
commissionamount integer (Required)
The total commission a hotel has to pay to OTA per complete reservation.
currencycode string (Required)
Currency code in which the booking has been made.
paymenttype string (Required)
Payment type for the booking.
hotel_id alphanumeric (Required)
The hotel id as used by IT Provider.
hotel_name alphanumeric (Required)
The hotel name as used by IT Provider.
paymentdue integer (Required)
The payment due details ** Currently only supported by Hostel world.
customer object (Required)
This object contains customer details such as address, cc _cvc, cc_expiration_date, cc_name, cc_number, cc_type, city, company, countrycode, dc_issue_number, dc_start_date, email, first_name, last_name, remarks, telephone, and zip.
corporate_booking_detail object (Required)
The corporate_booking_detail element contains the corporate level B2B booking details for taxation and billing.
booking_source string (Required)
The source of the booking.
tax_id string (Required)
Tax Id of billing company.
billing_company string (Required)
Name of billing company.
billing_address string (Required)
Address of billing company.
payment_information string (Required)
Payment information of B2B booking.
payment_due_date date (Required)
Payment due date of B2B booking.
booker_address string (Required)
Address of Booker.
booker_taxid string (Required)
Booker Tax Id.
booking_type string (Required)
Type of Booking.
currencycode string (Required)
In which currency OTA will charge the commission to the hotel.
address string (Required)
The address of the booker.
cc_cvc integer (Required)
CVC number of the credit card.
cc_expiration_date datetime (Optional)
The expiration date of the credit card.
cc_name string (Required)
Name of the credit card holder.
cc_number integer (Required)
The number of the credit card.
cc_type string (Required)
The type of credit card.
cc_current_balance string (Required)
Current balance of virtual credit card allocated by OTA.
cc_activation_date string (Required)
The activation date of the virtual credit card allocated by OTA.
vcc_expiration_date string (Required)
The expiration date of the virtual credit card allocated by OTA.
cc_token string (Required)
The token of credit card.
cc_token_expiration date (Required)
The expiry date of cc token generated.
cc_unique_code string (Required)
cc unique code - Value is assigned if Partner is integrated with Airpay payment gateway. Otherwise, empty node is passed.
city string (Required)
The city where the booker is from.
state string (Required)
The state where the booker is from.
countrycode string (Required)
The country code of the country where the booker is from.
email string (Required)
Email address supplied by the customer.
first_name string (Required)
First name of the booker as supplied by the custome.
last_name string (Required)
Last name of the booker as supplied by the customer.
remarks string (Required)
Remarks regarding this reservation, supplied by the customer.
telephone string (Required)
Telephone number as supplied by the customer.
zip string (Required)
Zip/Postal code as supplied by the customer.
cc_vault_token numeric (Required)
Token for cc number.
cc_tracking_id string (Required)
Tracking id for cc details.
rooms object
Root element of room.
Attribute
arrival_date datetime (Required)
Date of arrival of the guests.
departure_date datetime (Required)
Date of departure of the guests.
info string (Required)
Extra information for the room.
facilities string (Required)
Information over facilities included for the room (if allocated).
taxes object
Information of taxes charged on booking.
Attribute
name string (Required)
Name of the tax charged.
amount string (Required)
Amount of tax applied / charged.
specialrequest string (Required)
Special request made while making booking for the room (if allocated).
eta numerical (Required)
Estimate time for check in for this reservation as filled in on the website.
guest_name string (Required)
Guest name for this reservation as filled in on the website.
first_name string (Required)
Guest's First name for this reservation as filled in on the website.
last_name string (Required)
Guest's Last name for this reservation as filled in on the website.
id alphanumeric (Required)
The room type ID as used by IT Provider.
max_children integer (Optional)
The number of children included in the booked room.
numberofguests integer (Required)
It is the number of guests for this reservation as filled by the booker.
numberofchildren integer (Required)
It is the number of children for this reservation as filled by the booker.
numberofadults integer (Required)
It is the number of adults for this reservation as filled by the booker.
roomstaystatus string (Required)
The roomstaystatus ('new', 'modified' 'request' or 'cancelled') identifies the stay whether it is new, modified, request or cancelled.
roomreservation_id string (Required)
The room reservation ID as used by STAAH to identify the booked room within the reservation.
totalbeforetax integer (Required)
Total booking value before applying the taxes.
totaltax integer (Required)
The total amount of tax for this reservation. All rooms * all nights combined.
totalprice integer (Required)
The total price for this room before tax(s) for all nights combined, sum of all prices known at the moment of reservation (Before Taxes). Note that there may be some excluded charges from this price.
price alphanumeric (Required)
Price and rate category ID per night as known at the moment of reservation. The currency used for pricing is always the same for the hotel and set by OTA.
amount double (Required)
It contains the amount of per day pricing.
date alphanumeric (Required)
Date and time.
rate_id alphanumeric (Required)
Rate category ID per night as known at the moment of reservation.
mealplan_id integer (Required)
Meal plan ID per night as known at the moment of reservation.
mealplan alphanumeric (Required)
Meal plan name per night as known at the moment of reservation.
tax integer (Required)
Tax amount per night of reservation (Date wise).
pricebeforetax double (Required
Room rate amount per night of reservation before tax(s)(Date wise).
priceaftertax double (Required
Room rate amount per night of reservation after tax(s)(Date wise).
extra_adult_rate double (Required)
Extra rates for the additional adult.
extra_child_rate double (Required)
Extra rates for the additional child.
adults alphanumeric (Optional)
It is the name of additional adult/s for this reservation as filled by the booker.
addons alphanumeric (Optional)
Additional services added to the reservation.
name string (Optional)
The add-on name, in English.
nights integer (Optional)
Number of nights this customer has booked the addon for.
priceperunit integer (Optional)
The unitary price for this add-on.
pricemode integer (Optional)
An integer identifying the price mode (per stay, per night, per person per night). See table below for the values.
0
Not applicable
1
Per stay
2
Per person per stay
3
Per night
4
Per person per night
5
Percentage
6
Per person per night restricted
price integer (Optional)
The total calculated price for the add-on, taking into consideration the price mode.
taxes array
This array represents the detailed information about the taxes applied to an item (such as a room booking, product, or service). Each object in the taxes array includes the name and value of the tax. See below attributes:
Attributes
name string (Required)
The name or description of the tax.
value string (Required)
The value of the tax. This usually represents a percentage rate.
extracomponents alphanumeric (Required)
The tag contains details of all Extra / Other charges charged on a room. It is a room level value allocated from OTA and might vary as per rooms booked for multiple room reservation scenario.
name string (Required)
Name of the charged.
amount string (Required)
Amount of extra component applied/charged.
bed_type alphanumeric (Required)
The tag contains details of bed type.
affiliation object
Source Information of reservation.
Attribute
pos string (Required)
Point of sale of reservation.
source string (Required)
Source of reservation.
OTA_Code number (Required)
Source of reservation code or OTA code.
gstno alphanumeric (Required)
GST No. of the company for B2B booking.
companyname string (Required)
Name of B2B booking company (as allocated from OTA).
companyaddress string (Required)
Address of B2B company (As allocated from OTA).
chain_id alphanumeric (Required)
The chain id allocated from IT provider for the property
external_id alphanumeric (Required)
Instant booking reference - In the event of a property migrating from Instant (STAAH product) to Su.
otadue string (Required)
The amount OTA needs to pay to the property for the booking.
nettamount integer (Required)
The net amount of room of this reservation (Same value as of tag "totalprice"). All rooms * all nights combined excluding Taxes.
sellamount integer (Required)
The sell amount of room of this reservation (Same value as of tag "totalprice"). All rooms * all nights combined including Taxes.
cancelreason string (Required)
It specifies the reason for canceling a reservation
confirmationlink
The url through which one can confirm / deny the request of booking coming from VRBO. Only available under "request" booking from VRBO.
payment_charge numeric (Required)
Payment charged from OTA on the booking. Currently data is being allocated by http://Booking.com only.
channel_booking_id alphanumeric (Required)
Booking reference number of OTA.
thread_id alphanumeric (Required)
The thread ID as allocated by OTA / Channel (Supported by Airbnb only).
guest_id alphanumeric (Required)
The guest ID as allocated by OTA / Channel (Supported by Airbnb only).
numberofpets numeric (Required)
The number of pets as allocated by OTA / Channel.
numberofinfants numeric (Required)
The number of infants as allocated by OTA / Channel.
listingbaseprice numeric (Required)
Base price of the listing allocated from OTA / Channel (Supported by Airbnb Only).
processed_at datetime (Required)
Date and Time Stamp (HH:MM:SS) when the booking was processed (GMT Time).
Min:1 Max:1
Format - Date Time
deposit numeric (Required)
Deposit collected for a booking made / received.
cancellation_fee numeric (Required)
Deposit collected for a booking made / received.
vendor_booking_id string (Required)
The vendor booking id provided by some of the OTAs. (Empty node will be passed if no value received from OTA for booking)
id alphanumeric (Required)
The reservation ID as used by STAAH.
reservation_notif_id string (Required)
The reservation notification ID used to mark reservation as received.
modified_at date (Required)
Date when the status is modified.
status string (Required)
The reservation status ('new', 'modified' or 'cancelled').
totalprice integer (Required)
The total amount of room sales of this reservation. All rooms * all nights combined including Taxes. Note that there may be some excluded charges from this price.
totaltax integer (Required)
The total amount of tax for this reservation. All rooms * all nights combined.
discount double (Required)
Discount amount received from OTA.
extrafees object
Information of extra fees charged on booking ** Currently only supported by Airbnb. If no value allocated or for other channels, the node will be passed empty as "extrafees": [], and "taxes": []
Attribute
name string (Required)
Name of the extra fee charged.
amount string (Required)
Amount charged as extra fee.
taxes object
Information of taxes charged on booking ** Currently only supported by Airbnb. If no value allocated or for other channels, the node will be passed empty as <taxes></taxes>
Attribute
name string (Required)
Name of the tax charged.
amount string (Required)
Amount of tax applied / charged.
Response Model — New Reservation Confirmation
Sample Success Response
{
"reservations": [{
"booked_at": "2017-09-03",
"commissionamount": "72.63",
"currencycode": "NZD",
"paymenttype": "Hotel Collect",
"hotel_id": "11122010",
"hotel_name": "The Rosehotel Motel",
"paymentdue": "",
"customer": {
"corporate_booking_detail": {
"booking_source": "",
"tax_id": "",
"billing_company": "",
"billing_address": "",
"payment_information": "",
"payment_due_date": "",
"booker_address": "",
"booker_taxid": "",
"booking_type": ""
},
{
"address": "Holly Tree Barn Commonside",
"cc_cvc": "",
"cc_expiration_date": "",
"cc_name": "",
"cc_number": "",
"cc_type": "",
"cc_current_balance": "125.36",
"cc_activation_date": "2020-05-28",
"vcc_expiration_date": "2020-06-02",
"cc_token": "12589463532",
"cc_token_expiration": "2020-12-12",
"cc_unique_code": "c237b1ba20f5c2cbe32f47e6db1d1c58",
"city": "Frodsham",
"state": "",
"countrycode": "gb",
"email": "aparry.562285@guest.mail.com",
"first_name": "staah - Alun",
"last_name": "Parry",
"remarks": "Approximate time of arrival: between 17:00 and 18:00",
"telephone": "+44 7808 140655",
"zip": "WA6 9HA",
"cc_vault_token": "",
"cc_tracking_id": ""
},
"rooms": [{
"arrival_date": "2018-03-11",
"departure_date": "2018-03-13",
"info": "",
"facilities": "",
"taxes": [
{
"name": "Slab %",
"value": "175.0"
},
{
"name": "Flat %",
"value": "353.5"
}
],
"specialrequest": "",
"eta": "",
"guest_name": "Alun Parry",
"first_name": "Alun",
"last_name": "Parry",
"id": "1000202",
"max_children": "0",
"numberofguests": "2",
"numberofchildren": "0",
"numberofadults": "2",
"roomstaystatus": "new",
"roomreservation_id": "123654789",
"totalbeforetax": "568.98",
"totaltax": "63.22",
"totalprice": "632.20",
"price": [{
"amount": "174.49",
"date": "2018-03-11",
"rate_id": "1",
"mealplan_id": "15",
"mealplan": "Room Only",
"tax": "31.61",
"pricebeforetax": "174.49",
"priceaftertax": "206.1",
"extra_adult_rate" : "220",
"extra_child_rate" : "120"
}, {
"amount": "174.49",
"date": "2018-03-12",
"rate_id": "1",
"mealplan_id": "15",
"mealplan": "Room Only",
"tax": "31.61",
"pricebeforetax": "174.49",
"priceaftertax": "206.1"
}],
"adults": ["XXX XXX", "YYY YYY"],
"addons": [{
"name": "Breakfast",
"nights": "2",
"priceperunit": "18.00",
"pricemode": "4",
"price": "72.00",
"taxes": [
{
"name": "Slab %",
"value": "175.0"
},
{
"name": "Flat %",
"value": "353.5"
}
],
}],
"extracomponents": [{
"name": "Service Charge",
"value": "108"
}, {
"name": "Cleaning Fee",
"value": "40"
}],
"bed_type":"Queen"
}],
"affiliation": {
"pos": "Expedia",
"source": "expedia",
"OTA_Code": "9",
"gstno":"010101ABCD",
"companyname":"UltraTech",
"companyaddress":"Noida, Uttar Pradesh"
},
"chain_id": "Chain1",
"external_id": "";
"otadue": "",
"nettamount": "610.00",
"sellamount": "632.20",
"cancelreason": "",
"confirmationlink": "",
"payment_charge": "",
"channel_booking_id": "180538ABD2269",
"thread_id": "20101986",
"guest_id": "101986",
"numberofpets": "",
"numberofinfants": "",
"listingbaseprice": "110",
"processed_at": "2021-08-13 05:43:10",
"deposit": "10.20",
"cancellation_fee": "",
"vendor_booking_id": "NH7201152942756",
"id": "1805382269_11122010",
"reservation_notif_id": "152420368316228301205",
"modified_at": "2017-09-03",
"status": "new",
"totalprice": "632.20",
"totaltax": "63.22",
"discount": "28.2",
"extrafees": [{
"name": "Airbnb Service",
"amount": "22.05"
}, {
"name": "Airbnb S1ervice",
"amount": "22.05"
}],
"taxes": [{
"name": "VAT\/GST (Ptt_authority_175960)",
"amount": "43.22"
}, {
"name": "Tourist Tax (Ptt_authority_175961)",
"amount": "20.00"
}]
}]
}Response Model — Modified Reservation
Sample Success Response
{
"reservations": [{
"booked_at": "2017-09-03",
"commissionamount": "72.63",
"currencycode": "NZD",
"paymenttype": "Hotel Collect",
"hotel_id": "11122010",
"hotel_name": "The Rosehotel Motel",
"paymentdue": "",
"customer": {
"corporate_booking_detail": {
"booking_source": "",
"tax_id": "",
"billing_company": "",
"billing_address": "",
"payment_information": "",
"payment_due_date": "",
"booker_address": "",
"booker_taxid": "",
"booking_type": ""
},
{
"address": "Holly Tree Barn Commonside",
"cc_cvc": "",
"cc_expiration_date": "",
"cc_name": "",
"cc_number": "",
"cc_type": "",
"cc_current_balance": "125.36",
"cc_activation_date": "2020-05-28",
"vcc_expiration_date": "2020-06-02",
"cc_token": "12589463532",
"cc_token_expiration": "2020-12-12",
"cc_unique_code": "c237b1ba20f5c2cbe32f47e6db1d1c58",
"city": "Frodsham",
"state": "",
"countrycode": "gb",
"email": "aparry.562285@guest.mail.com",
"first_name": "staah - Alun",
"last_name": "Parry",
"remarks": "Approximate time of arrival: between 17:00 and 18:00",
"telephone": "+44 7808 140655",
"zip": "WA6 9HA",
"cc_vault_token": "",
"cc_tracking_id": ""
},
"rooms": [{
"arrival_date": "2018-03-11",
"departure_date": "2018-03-13",
"info": "",
"facilities": "",
"taxes": [
{
"name": "Slab %",
"value": "175.0"
},
{
"name": "Flat %",
"value": "353.5"
}
],
"specialrequest": "",
"eta": "",
"guest_name": "Alun Parry",
"first_name": "Alun",
"last_name": "Parry",
"id": "1000202",
"max_children": "0",
"numberofguests": "2",
"numberofchildren": "0",
"numberofadults": "2",
"roomstaystatus": "new",
"roomreservation_id": "123654789",
"totalbeforetax": "568.98",
"totaltax": "63.22",
"totalprice": "632.20",
"price": [{
"amount": "174.49",
"date": "2018-03-11",
"rate_id": "1",
"mealplan_id": "15",
"mealplan": "Room Only",
"tax": "31.61",
"pricebeforetax": "174.49",
"priceaftertax": "206.1",
"extra_adult_rate" : "220",
"extra_child_rate" : "120"
}, {
"amount": "174.49",
"date": "2018-03-12",
"rate_id": "1",
"mealplan_id": "15",
"mealplan": "Room Only",
"tax": "31.61",
"pricebeforetax": "174.49",
"priceaftertax": "206.1"
}],
"adults": ["XXX XXX", "YYY YYY"],
"addons": [{
"name": "Breakfast",
"nights": "2",
"priceperunit": "18.00",
"pricemode": "4",
"price": "72.00",
"taxes": [
{
"name": "Slab %",
"value": "175.0"
},
{
"name": "Flat %",
"value": "353.5"
}
],
}],
"extracomponents": [{
"name": "Service Charge",
"value": "108"
}, {
"name": "Cleaning Fee",
"value": "40"
}],
"bed_type":"Queen"
}],
"affiliation": {
"pos": "Expedia",
"source": "expedia",
"OTA_Code": "9",
"gstno":"010101ABCD",
"companyname":"UltraTech",
"companyaddress":"Noida, Uttar Pradesh"
},
"chain_id": "Chain1",
"external_id": "";
"otadue": "",
"nettamount": "610.00",
"sellamount": "632.20",
"cancelreason": "",
"confirmationlink": "",
"payment_charge": "",
"channel_booking_id": "180538ABD2269",
"thread_id": "20101986",
"guest_id": "101986",
"numberofpets": "",
"numberofinfants": "",
"listingbaseprice": "110",
"processed_at": "2021-08-13 05:43:10",
"deposit": "10.20",
"cancellation_fee": "",
"vendor_booking_id": "NH7201152942756",
"id": "1805382269_11122010",
"reservation_notif_id": "152420368316228301205",
"modified_at": "2017-09-03",
"status": "modified",
"totalprice": "632.20",
"totaltax": "63.22",
"discount": "28.2",
"extrafees": [{
"name": "Airbnb Service",
"amount": "22.05"
}, {
"name": "Airbnb S1ervice",
"amount": "22.05"
}],
"taxes": [{
"name": "VAT\/GST (Ptt_authority_175960)",
"amount": "43.22"
}, {
"name": "Tourist Tax (Ptt_authority_175961)",
"amount": "20.00"
}]
}]
}Response Model — Request Booking
Sample Success Response
{
"reservations": [{
"booked_at": "2017-09-03",
"commissionamount": "72.63",
"currencycode": "NZD",
"paymenttype": "Hotel Collect",
"hotel_id": "11122010",
"hotel_name": "The Rosehotel Motel",
"paymentdue": "",
"customer": {
"corporate_booking_detail": {
"booking_source": "",
"tax_id": "",
"billing_company": "",
"billing_address": "",
"payment_information": "",
"payment_due_date": "",
"booker_address": "",
"booker_taxid": "",
"booking_type": ""
},
{
"address": "Holly Tree Barn Commonside",
"cc_cvc": "",
"cc_expiration_date": "",
"cc_name": "",
"cc_number": "",
"cc_type": "",
"cc_current_balance": "125.36",
"cc_activation_date": "2020-05-28",
"vcc_expiration_date": "2020-06-02",
"cc_token": "12589463532",
"cc_token_expiration": "2020-12-12",
"cc_unique_code": "c237b1ba20f5c2cbe32f47e6db1d1c58",
"city": "Frodsham",
"state": "",
"countrycode": "gb",
"email": "aparry.562285@guest.mail.com",
"first_name": "staah - Alun",
"last_name": "Parry",
"remarks": "Approximate time of arrival: between 17:00 and 18:00",
"telephone": "+44 7808 140655",
"zip": "WA6 9HA",
"cc_vault_token": "",
"cc_tracking_id": ""
},
"rooms": [{
"arrival_date": "2018-03-11",
"departure_date": "2018-03-13",
"info": "",
"facilities": "",
"taxes": [
{
"name": "Slab %",
"value": "175.0"
},
{
"name": "Flat %",
"value": "353.5"
}
],
"specialrequest": "",
"eta": "",
"guest_name": "Alun Parry",
"first_name": "Alun",
"last_name": "Parry",
"id": "1000202",
"max_children": "0",
"numberofguests": "2",
"numberofchildren": "0",
"numberofadults": "2",
"roomstaystatus": "new",
"roomreservation_id": "123654789",
"totalbeforetax": "568.98",
"totaltax": "63.22",
"totalprice": "632.20",
"price": [{
"amount": "174.49",
"date": "2018-03-11",
"rate_id": "1",
"mealplan_id": "15",
"mealplan": "Room Only",
"tax": "31.61",
"pricebeforetax": "174.49",
"priceaftertax": "206.1",
"extra_adult_rate" : "220",
"extra_child_rate" : "120"
}, {
"amount": "174.49",
"date": "2018-03-12",
"rate_id": "1",
"mealplan_id": "15",
"mealplan": "Room Only",
"tax": "31.61",
"pricebeforetax": "174.49",
"priceaftertax": "206.1"
}],
"adults": ["XXX XXX", "YYY YYY"],
"addons": [{
"name": "Breakfast",
"nights": "2",
"priceperunit": "18.00",
"pricemode": "4",
"price": "72.00",
"taxes": [
{
"name": "Slab %",
"value": "175.0"
},
{
"name": "Flat %",
"value": "353.5"
}
],
}],
"extracomponents": [{
"name": "Service Charge",
"value": "108"
}, {
"name": "Cleaning Fee",
"value": "40"
}],
"bed_type":"Queen"
}],
"affiliation": {
"pos": "Expedia",
"source": "expedia",
"OTA_Code": "9",
"gstno":"010101ABCD",
"companyname":"UltraTech",
"companyaddress":"Noida, Uttar Pradesh"
},
"chain_id": "Chain1",
"external_id": "";
"otadue": "",
"nettamount": "610.00",
"sellamount": "632.20",
"cancelreason": "",
"confirmationlink": "xxxxx.suissu.com/SUAPI/service/requesturls/1-TDhKTFbhp5pm-ulH7VrIUsPOD4qkRO0",
"payment_charge": "",
"channel_booking_id": "180538ABD2269",
"thread_id": "20101986",
"guest_id": "101986",
"numberofpets": "",
"numberofinfants": "",
"listingbaseprice": "110",
"processed_at": "2021-08-13 05:43:10",
"deposit": "10.20",
"cancellation_fee": "",
"vendor_booking_id": "NH7201152942756",
"id": "1805382269_11122010",
"reservation_notif_id": "152420368316228301205",
"modified_at": "2017-09-03",
"status": "request",
"totalprice": "632.20",
"totaltax": "63.22",
"discount": "28.2",
"extrafees": [{
"name": "Airbnb Service",
"amount": "22.05"
}, {
"name": "Airbnb S1ervice",
"amount": "22.05"
}],
"taxes": [{
"name": "VAT\/GST (Ptt_authority_175960)",
"amount": "43.22"
}, {
"name": "Tourist Tax (Ptt_authority_175961)",
"amount": "20.00"
}]
}]
}Response Model - Cancelled Reservation
{
"reservations": [{
"booked_at": "2020-08-24",
"commissionamount": "28.6",
"currencycode": "GBP",
"paymenttype": "Hotel Collect",
"hotel_id": "KC",
"hotel_name": "Kings Cross",
"paymentdue": "",
"customer": {
"corporate_booking_detail": {
"booking_source": "",
"tax_id": "",
"billing_company": "",
"billing_address": "",
"payment_information": "",
"payment_due_date": "",
"booker_address": "",
"booker_taxid": "",
"booking_type": ""
},
{
"address": "24th Street",
"cc_cvc": "",
"cc_expiration_date": "0225",
"cc_name": "Trushant Pore",
"cc_number": "4111111111111111",
"cc_type": "VI",
"cc_current_balance": "",
"cc_activation_date": "",
"vcc_expiration_date": "",
"cc_token": "",
"cc_token_expiration": "",
"cc_unique_code": "",
"city": "Auckland",
"state": "",
"countrycode": "New Zealand",
"email": "no-reply@suissu.com",
"first_name": "Sam",
"last_name": "Thomas",
"remarks": "Approximate time of arrival: between 17:00 and 18:00Are double beds available?",
"telephone": "1234566789",
"zip": "12345",
"cc_vault_token": "",
"cc_tracking_id": ""
},
"rooms": [{
"arrival_date": "2020-09-10",
"departure_date": "2020-09-12",
"info": "\n\t\t\t\t\tThis modern room is equipped with a work desk and a flat-screen TV with satellite channels. Enjoy a convenient Breakfast at the property for USD 18 per person, per night. Children and Extra Bed Policy: Children cannot be accommodated at the hotel. There is no capacity for extra beds in the room. Deposit Policy: 100 percent of the first night may be charged anytime after booking. Cancellation Policy: If cancelled or modified up to 1 day before the date of arrival, no fee will be charged. If cancelled or modified later or in case of no-show, 100 percent of the first night will be charged.\n\t\t\t\t\t",
"facilities": "No Smoking Meal plan :Enjoy a convenient Breakfast at the property for USD 18 per person, per night. rewritten_from_name : SECRET DEAL genius_rate : no",
"taxes": [
{
"name": "Slab %",
"value": "175.0"
},
{
"name": "Flat %",
"value": "353.5"
}
],
"specialrequest": "",
"eta": "",
"guest_name": "Sam Thomas",
"first_name": "Sam",
"last_name": "Thomas",
"id": "STD",
"max_children": "0",
"numberofguests": "2",
"numberofchildren": "0",
"numberofadults": "2",
"roomstaystatus": "cancelled",
"roomreservation_id": "1598272591656",
"totalbeforetax": "286",
"totaltax": "0",
"totalprice": "286",
"price": [{
"amount": "174.49",
"date": "2020-09-10",
"rate_id": "BAR",
"mealplan_id": "1",
"mealplan": "All inclusive",
"tax": "0",
"pricebeforetax": "125",
"priceaftertax": "125",
"extra_adult_rate" : "220",
"extra_child_rate" : "120"
}, {
"amount": "174.49",
"date": "2020-09-11",
"rate_id": "BAR",
"mealplan_id": "1",
"mealplan": "All inclusive",
"tax": "0",
"pricebeforetax": "125",
"priceaftertax": "125"
}],
"adults": ["XXX XXX", "YYY YYY"],
"addons": [{
"name": "Breakfast",
"nights": "2",
"priceperunit": "18.00",
"pricemode": "4",
"price": "36",
"taxes": [
{
"name": "Slab %",
"value": "175.0"
},
{
"name": "Flat %",
"value": "353.5"
}
],
}],
"extracomponents": [],
"bed_type":"Queen"
}],
"affiliation": {
"pos": "Expedia",
"source": "expedia",
"OTA_Code": "9",
"gstno":"010101ABCD",
"companyname":"UltraTech",
"companyaddress":"Noida, Uttar Pradesh"
},
"chain_id": "Chain1",
"external_id": "";
"otadue": "",
"nettamount": "270",
"sellamount": "286",
"cancelreason": "I made a mistake with the booking dates and need to cancel my reservation.",
"confirmationlink": "",
"payment_charge": "",
"channel_booking_id": "180538ABD2269",
"thread_id": "20101986",
"guest_id": "101986",
"numberofpets": "",
"numberofinfants": "",
"listingbaseprice": "110",
"processed_at": "2021-08-13 05:43:10",
"deposit": "10.20",
"cancellation_fee": "",
"vendor_booking_id": "122543543",
"id": "040736750_KC",
"reservation_notif_id": "159827327984387346046",
"modified_at": "2020-08-24",
"status": "cancelled",
"totalprice": "286",
"totaltax": "5",
"discount": "28.2",
"extrafees": [{
"name": "Airbnb Service",
"amount": "22.05"
}, {
"name": "Airbnb S1ervice",
"amount": "22.05"
}],
"taxes": [{
"name": "VAT/GST (Ptt_authority_175960)",
"amount": "43.22"
}, {
"name": "Tourist Tax (Ptt_authority_175961)",
"amount": "20.00"
}]
}]
}Response Model — Multiple Room Reservation
Sample Success Response
{
"reservations": [{
"booked_at": "2020-08-24",
"commissionamount": "31.6",
"currencycode": "GBP",
"paymenttype": "Channel Collect",
"hotel_id": "KC",
"hotel_name": "Kings Cross",
"paymentdue": "",
"customer": {
"corporate_booking_detail": {
"booking_source": "",
"tax_id": "",
"billing_company": "",
"billing_address": "",
"payment_information": "",
"payment_due_date": "",
"booker_address": "",
"booker_taxid": "",
"booking_type": ""
},
{
"address": "24th Street",
"cc_cvc": "",
"cc_expiration_date": "0225",
"cc_name": "Trushant Pore",
"cc_number": "4111111111111111",
"cc_type": "VI",
"cc_current_balance": "",
"cc_activation_date": "",
"vcc_expiration_date": "",
"cc_token": "",
"cc_token_expiration": "",
"cc_unique_code": "",
"city": "Auckland",
"state": "",
"countrycode": "New Zealand",
"email": "no-reply@suissu.com",
"first_name": "Paul",
"last_name": "Chris",
"remarks": "Approximate time of arrival: between 17:00 and 18:00Are double beds available?",
"telephone": "123456789",
"zip": "12345",
"cc_vault_token": "",
"cc_tracking_id": ""
},
"rooms": [{
"arrival_date": "2020-08-24",
"departure_date": "2020-08-25",
"info": "\n\t\t\t\t\tThis modern room is equipped with a work desk and a flat-screen TV with satellite channels. Enjoy a convenient Breakfast at the property for USD 18 per person, per night. Children and Extra Bed Policy: Children cannot be accommodated at the hotel. There is no capacity for extra beds in the room. Deposit Policy: 100 percent of the first night may be charged anytime after booking. Cancellation Policy: If cancelled or modified up to 1 day before the date of arrival, no fee will be charged. If cancelled or modified later or in case of no-show, 100 percent of the first night will be charged.\n\t\t\t\t\t",
"facilities": "No Smoking Meal plan :Enjoy a convenient Breakfast at the property for USD 18 per person, per night. rewritten_from_name : SECRET DEAL genius_rate : no",
"taxes": [
{
"name": "Slab %",
"value": "175.0"
},
{
"name": "Flat %",
"value": "353.5"
}
],
"specialrequest": "",
"eta": "",
"guest_name": "Paul Chris",
"first_name": "Paul",
"last_name": "Chris",
"id": "STD",
"max_children": "0",
"numberofguests": "2",
"numberofchildren": "0",
"numberofadults": "2",
"roomstaystatus": "new",
"roomreservation_id": "1598274401030",
"totalbeforetax": "261",
"totaltax": "5",
"totalprice": "266",
"price": [{
"amount": "174.49",
"date": "2020-08-24",
"rate_id": "BAR",
"mealplan_id": "1",
"mealplan": "All inclusive",
"tax": "4",
"pricebeforetax": "136",
"priceaftertax": "140",
"extra_adult_rate" : "220",
"extra_child_rate" : "120"
}],
"adults": ["XXX XXX", "YYY YYY"],
"addons": [{
"name": "Breakfast",
"nights": "1",
"priceperunit": "18.00",
"pricemode": "4",
"price": "18",
"taxes": [
{
"name": "Slab %",
"value": "175.0"
},
{
"name": "Flat %",
"value": "353.5"
}
],
}],
"extracomponents": [{
"name": "service charge",
"value": "108"
}],
"bed_type":"Queen"
}, {
"arrival_date": "2020-08-26",
"departure_date": "2020-08-27",
"info": "\n\t\t\t\t\tThis modern room is equipped with a work desk and a flat-screen TV with satellite channels. Enjoy a convenient Breakfast at the property for USD 18 per person, per night. Children and Extra Bed Policy: Children cannot be accommodated at the hotel. There is no capacity for extra beds in the room. Deposit Policy: 100 percent of the first night may be charged anytime after booking. Cancellation Policy: If cancelled or modified up to 1 day before the date of arrival, no fee will be charged. If cancelled or modified later or in case of no-show, 100 percent of the first night will be charged.\n\t\t\t\t\t",
"facilities": "No Smoking Meal plan :Enjoy a convenient Breakfast at the property for USD 18 per person, per night. rewritten_from_name : SECRET DEAL genius_rate : no",
"taxes": [
{
"name": "Slab %",
"value": "175.0"
},
{
"name": "Flat %",
"value": "353.5"
}
],
"specialrequest": "",
"eta": "",
"guest_name": "Paul Chris",
"first_name": "Paul",
"last_name": "Chris",
"id": "STD1",
"max_children": "0",
"numberofguests": "2",
"numberofchildren": "0",
"numberofadults": "2",
"roomstaystatus": "new",
"roomreservation_id": "1598274398684",
"totalbeforetax": "261",
"totaltax": "5",
"totalprice": "266",
"price": [{
"amount": "174.49",
"date": "2020-08-26",
"rate_id": "BAR",
"mealplan_id": "1",
"mealplan": "All inclusive",
"tax": "4",
"pricebeforetax": "136",
"priceaftertax": "140",
"extra_adult_rate" : "220",
"extra_child_rate" : "120"
}],
"adults": ["XXX XXX", "YYY YYY"],
"addons": [{
"name": "Breakfast",
"nights": "1",
"priceperunit": "18.00",
"pricemode": "4",
"price": "18",
"taxes": [
{
"name": "Slab %",
"value": "175.0"
},
{
"name": "Flat %",
"value": "353.5"
}
],
}],
"extracomponents": [{
"name": "service charge",
"value": "108"
}],
"bed_type":"Queen"
}],
"affiliation": {
"pos": "Expedia",
"source": "expedia",
"OTA_Code": "9",
"gstno":"010101ABCD",
"companyname":"UltraTech",
"companyaddress":"Noida, Uttar Pradesh"
},
"chain_id": "Chain1",
"external_id": "";
"otadue": "",
"nettamount": "520",
"sellamount": "532",
"cancelreason": "",
"confirmationlink": "",
"payment_charge": "",
"channel_booking_id": "180538ABD2269",
"thread_id": "20101986",
"guest_id": "101986",
"numberofpets": "",
"numberofinfants": "",
"listingbaseprice": "110",
"processed_at": "2021-08-13 05:43:10",
"deposit": "10.20",
"cancellation_fee": "",
"vendor_booking_id": "122543543",
"id": "232368879_KC",
"reservation_notif_id": "159827439307556534166",
"modified_at": "2020-08-24",
"status": "new",
"totalprice": "532",
"totaltax": "10",
"discount": "28.2",
"extrafees": [],
"taxes": []
}]
}Multiple Room Reservation
System allows to have multiple rooms to be booked under same reservation with different Guest, Check In/Out dates, Room type, Rate Plan, etc. These reservations can be retrieved through the same API request. Refer to Response Model — Multiple Room Reservation for reference.
Errors
Errors due to Invalid Parameters
{
"Status": "Fail",
"Errors": {
"Code": "950",
"ShortText": "Reservation Not Found"
}
}Last updated
Was this helpful?