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": []
}

---

Attributes

reservations array (Required)

List of reservation objects.

Min:1 Max:1

---

reservation (Required)

Every reservation is indicated with a 'reservation' element.

Min:1 Max:10

Children - commissionamount, currencycode, customer, 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, zip, date, hotel_id, hotel_name, id, room, addons, addon, name, nights, persons, price_mode, price_per_unit, totalprice, type, arrival_date, commissionamount, currencycode, departure_date, extra_info, guest_name, id, info, name, numberofguests, price, remarks, roomreservation_id, smoking, totalprice, status, time, and totalprice

---

booked_at date (Required)

Date when the booking has been made.

Min:1 Max:1

Format Date: YYYY-MM-DD

---

commissionamount integer (Required)

The total commission a hotel has to pay to OTA per complete reservation.

Min:1 Max:1

---

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.

Min:1 Max:1

Maximum 20 characters allowed.

---

hotel_name alphanumeric (Required)

The hotel name as used by IT Provider.

Min:1 Max:1

---

paymentdue integer (Required)

The payment due details ** Currently only supported by Hostel world.

Min:1 Max:1

---

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.

Min:1 Max:1

---

corporate_booking_detail object (Required)

The corporate_booking_detail element contains the corporate level B2B booking details for taxation and billing.

Min:1 Max:1

---

booking_source string (Required)

The source of the booking.

Min:1 Max:1

---

tax_id string (Required)

Tax Id of billing company.

Min:1 Max:1

---

billing_company string (Required)

Name of billing company.

Min:1 Max:1

---

billing_address string (Required)

Address of billing company.

Min:1 Max:1

---

payment_information string (Required)

Payment information of B2B booking.

Min:1 Max:1

---

payment_due_date date (Required)

Payment due date of B2B booking.

Min:1 Max:1

---

booker_address string (Required)

Address of Booker.

Min:1 Max:1

---

booker_taxid string (Required)

Booker Tax Id.

Min:1 Max:1

---

booking_type string (Required)

Type of Booking.

Min:1 Max:1

---

currencycode string (Required)

In which currency OTA will charge the commission to the hotel.

Min:1 Max:1

---

address string (Required)

The address of the booker.

Min:1 Max:1

---

cc_cvc integer (Required)

CVC number of the credit card.

Min:1 Max:1

---

cc_expiration_date datetime (Optional)

The expiration date of the credit card.

Min:0 Max:1

Format MMYY

---

cc_name string (Required)

Name of the credit card holder.

Min:1 Max:1

---

cc_number integer (Required)

The number of the credit card.

Min:1 Max:1

---

cc_type string (Required)

The type of credit card.

Min:1 Max:1

---

cc_current_balance string (Required)

Current balance of virtual credit card allocated by OTA.

Min:1 Max:1

---

cc_activation_date string (Required)

The activation date of the virtual credit card allocated by OTA.

Min:1 Max:1

Format Date: YYYY-MM-DD

---

vcc_expiration_date string (Required)

The expiration date of the virtual credit card allocated by OTA.

Min:1 Max:1

Format Date: YYYY-MM-DD

---

cc_token string (Required)

The token of credit card.

Min:1 Max:1

---

cc_token_expiration date (Required)

The expiry date of cc token generated.

Min:1 Max:1

---

cc_unique_code string (Required)

cc unique code - Value is assigned if Partner is integrated with Airpay payment gateway. Otherwise, empty node is passed.

Min:1 Max:1

---

city string (Required)

The city where the booker is from.

Min:1 Max:1

---

state string (Required)

The state where the booker is from.

Min:1 Max:1

---

countrycode string (Required)

The country code of the country where the booker is from.

Min:1 Max:1

---

email string (Required)

Email address supplied by the customer.

Min:1 Max:1

---

first_name string (Required)

First name of the booker as supplied by the custome.

Min:1 Max:1

---

last_name string (Required)

Last name of the booker as supplied by the customer.

Min:1 Max:1

---

remarks string (Required)

Remarks regarding this reservation, supplied by the customer.

Min:1 Max:1

---

telephone string (Required)

Telephone number as supplied by the customer.

Min:1 Max:1

---

zip string (Required)

Zip/Postal code as supplied by the customer.

Min:1 Max:1

---

cc_vault_token numeric (Required)

Token for cc number.

Min:1 Max:1

---

cc_tracking_id string (Required)

Tracking id for cc details.

Min:1 Max:1

---

rooms object

Root element of room.

Min:1 Max:1

---

Attribute

arrival_date datetime (Required)

Date of arrival of the guests.

Min:1 Max:1

Format - YYYY-MM-DD

---

departure_date datetime (Required)

Date of departure of the guests.

Min:1 Max:1

Format - YYYY-MM-DD

---

info string (Required)

Extra information for the room.

Min:1 Max:1

---

facilities string (Required)

Information over facilities included for the room (if allocated).

Min:1 Max:1

taxes object

Information of taxes charged on booking.

Attribute

---

name string (Required)

Name of the tax charged.

Min:1 Max:1

---

amount string (Required)

Amount of tax applied / charged.

Min:1 Max:1

---

specialrequest string (Required)

Special request made while making booking for the room (if allocated).

Min:1 Max:1

---

eta numerical (Required)

Estimate time for check in for this reservation as filled in on the website.

Min:1 Max:1

---

guest_name string (Required)

Guest name for this reservation as filled in on the website.

Min:1 Max:1

---

first_name string (Required)

Guest's First name for this reservation as filled in on the website.

Min:1 Max:1

---

last_name string (Required)

Guest's Last name for this reservation as filled in on the website.

Min:1 Max:1

---

id alphanumeric (Required)

The room type ID as used by IT Provider.

Min:1 Max:1

---

max_children integer (Optional)

The number of children included in the booked room.

Min:0 Max:1

---

numberofguests integer (Required)

It is the number of guests for this reservation as filled by the booker.

Min:1 Max:1

---

numberofchildren integer (Required)

It is the number of children for this reservation as filled by the booker.

Min:1 Max:1

---

numberofadults integer (Required)

It is the number of adults for this reservation as filled by the booker.

Min:1 Max:1

---

roomstaystatus string (Required)

The roomstaystatus ('new', 'modified' 'request' or 'cancelled') identifies the stay whether it is new, modified, request or cancelled.

Min:1 Max:1

---

roomreservation_id string (Required)

The room reservation ID as used by STAAH to identify the booked room within the reservation.

Min:1 Max:1

---

totalbeforetax integer (Required)

Total booking value before applying the taxes.

Min:1 Max:1

---

totaltax integer (Required)

The total amount of tax for this reservation. All rooms * all nights combined.

Min:1 Max:1

---

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.

Min:1 Max:1

---

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.

Min:1 Max:unbounded

---

amount double (Required)

It contains the amount of per day pricing.

Value for this parameter will be numeric with possible decimal point.

Min:1 Max:unbounded

---

date alphanumeric (Required)

Date and time.

Format: YYYY-MM-DD

---

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.

Min:1 Max:1

---

mealplan alphanumeric (Required)

Meal plan name per night as known at the moment of reservation.

Min:1 Max:1

---

tax integer (Required)

Tax amount per night of reservation (Date wise).

Min:1 Max:1

---

pricebeforetax double (Required

Room rate amount per night of reservation before tax(s)(Date wise).

Min:1 Max:1

---

priceaftertax double (Required

Room rate amount per night of reservation after tax(s)(Date wise).

Min:1 Max:1

---

extra_adult_rate double (Required)

Extra rates for the additional adult.

Min:1 Max:1

---

extra_child_rate double (Required)

Extra rates for the additional child.

Min:1 Max:1

---

adults alphanumeric (Optional)

It is the name of additional adult/s for this reservation as filled by the booker.

Min:0 Max:1

---

addons alphanumeric (Optional)

Additional services added to the reservation.

---

name string (Optional)

The add-on name, in English.

Min:0 Max:1

---

nights integer (Optional)

Number of nights this customer has booked the addon for.

Min:0 Max:1

---

priceperunit integer (Optional)

The unitary price for this add-on.

Min:0 Max:1

---

pricemode integer (Optional)

An integer identifying the price mode (per stay, per night, per person per night). See table below for the values.

Min:0 Max:1

ID	PRICE MODE
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.

Min:0 Max:1

---

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.

Example Values:

• "Slab %": Indicates a slab-based tax, possibly percentage-based where the rate varies based on predefined slabs or tiers.

• "Flat %": Indicates a flat rate percentage tax, where a constant percentage is applied.

---

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.

Min:1 Max:1

---

amount string (Required)

Amount of extra component applied/charged.

Min:1 Max:1

---

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 (as allocated from OTA).

Min:1 Max:1

---

source string (Required)

Source of reservation.

Min:1 Max:1

---

OTA_Code number (Required)

Source of reservation code or OTA code.

---

gstno alphanumeric (Required)

GST No. of the company for B2B booking (as allocated from OTA).

Min:1 Max:1

---

companyname string (Required)

Name of B2B booking company (as allocated from OTA).

Min:1 Max:1

---

companyaddress string (Required)

Address of B2B company (as allocated from OTA).

---

companyemail string (Optional)

Specifies the company’s contact email address(es) associated with the reservation (as allocated from OTA).

Multiple email addresses are supported and will be provided as a comma-separated list.

---

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.

Min:1 Max:1

---

nettamount integer (Required)

The net amount of room of this reservation (Same value as of tag "totalprice"). All rooms * all nights combined excluding Taxes.

Min:1 Max:1

---

sellamount integer (Required)

The sell amount of room of this reservation (Same value as of tag "totalprice"). All rooms * all nights combined including Taxes.

Min:1 Max:1

---

cancelreason string (Required)

It specifies the reason for canceling a reservation

Min:1 Max:1

---

confirmationlink

The url through which one can confirm / deny the request of booking coming from VRBO. Only available under "request" booking from VRBO.

Min:1 Max:1

---

payment_charge numeric (Required)

Payment charged from OTA on the booking. Currently data is being allocated by http://Booking.com only.

Min:1 Max:1

---

channel_booking_id alphanumeric (Required)

Booking reference number of OTA.

Min:1 Max:1

---

thread_id alphanumeric (Required)

The thread ID as allocated by OTA / Channel (Supported by Airbnb only).

Min:1 Max:1

---

guest_id alphanumeric (Required)

The guest ID as allocated by OTA / Channel (Supported by Airbnb only).

Min:1 Max:1

---

numberofpets numeric (Required)

The number of pets as allocated by OTA / Channel.

Min:1 Max:1

---

numberofinfants numeric (Required)

The number of infants as allocated by OTA / Channel.

Min:1 Max:1

---

listingbaseprice numeric (Required)

Base price of the listing allocated from OTA / Channel (Supported by Airbnb Only).

Min:1 Max:1

---

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.

Min:1 Max:1

---

cancellation_fee numeric (Required)

Deposit collected for a booking made / received.

Min:1 Max:1

---

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.

Min:1 Max:1

---

modified_at date (Required)

Date when the status is modified.

---

status string (Required)

The reservation status ('new', 'modified' or 'cancelled').

Min:1 Max:1

---

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.

Min:1 Max:1

---

totaltax integer (Required)

The total amount of tax for this reservation. All rooms * all nights combined.

Min:1 Max:1

---

discount double (Required)

Discount amount received from OTA.

Min:1 Max:1

---

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.

Min:1 Max:1

---

amount string (Required)

Amount charged as extra fee.

Min:1 Max:1

---

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.

Min:1 Max:1

---

amount string (Required)

Amount of tax applied / charged.

Min:1 Max:1

---

addons object

Additional services or products added to a room reservation (for example, breakfast, parking, airport transfer, etc.).

---

name string

The add-on name, as provided by the OTA.

---

nights integer

Number of nights this add-on is applicable for. This value is usually populated when the add-on is charged per night.

---

priceperunit integer

The unit price of the add-on. For example, the price per person, per night, or per stay depending on the price mode.

---

pricemode string

A string value identifying how the add-on price is calculated. The pricing mode is defined by the OTA and may vary; values are not limited to the predefined list below.

Possible values:

ID	PRICE MODE
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 double

The total calculated price for the add-on, derived based on the price mode, number of nights, and number of persons (if applicable).

---

comment string

Additional comments or notes related to the add-on, if provided by the OTA.

---

pricebeforetax integer

The total price of the add-on before applying any taxes.

---

tax integer

The total tax amount applied to this add-on.

---

taxes array

This array represents the detailed information about taxes applied to the add-on. If no tax is applicable, this array may be empty.

---

ota_addon_id alphanumeric

The unique identifier of the add-on as provided by the OTA. This ID can be used for reference, reconciliation, or mapping with OTA systems.

---

Response Model — New Reservation Confirmation

Sample Success Response

{
    "reservations": [
        {
            "booked_at": "2025-07-23 06:18:41",
            "commissionamount": "",
            "currencycode": "NZD",
            "paymenttype": "Hotel Collect",
            "hotel_id": "TPBE",
            "hotel_name": "TPBE",
            "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": "",
                "cc_cvc": "",
                "cc_expiration_date": "",
                "cc_name": "",
                "cc_number": "",
                "cc_type": "",
                "cc_current_balance": "",
                "cc_activation_date": "",
                "vcc_expiration_date": "",
                "cc_token": "",
                "cc_token_expiration": "",
                "cc_unique_code": "",
                "city": "",
                "state": "",
                "countrycode": "IN",
                "email": "[e-mail]",
                "first_name": " john",
                "last_name": "doe",
                "remarks": " booking_fees :: 315.00 ||  booking_fees :: 28.00",
                "telephone": "[phone]",
                "zip": "",
                "guest_lang": "en",
                "cc_vault_token": "",
                "cc_tracking_id": "",
                "tokensource": "",
                "tokentype": "",
                "token_id": "",
                "cc_virtual": "0"
            },
            "rooms": [
                {
                    "arrival_date": "2025-08-14",
                    "departure_date": "2025-08-15",
                    "info": "",
                    "facilities": "",
                    "taxes": [
                        {
                            "name": "GST",
                            "value": "135.00"
                        },
                        {
                            "name": "Credit card fee (2.8%)",
                            "value": "38.00"
                        },
                        {
                            "name": "New sales",
                            "value": "50.00"
                        },
                        {
                            "name": "TAX",
                            "value": "100.00"
                        }
                    ],
                    "specialrequest": "",
                    "eta": "01:30 am",
                    "guest_name": "john doe",
                    "first_name": "john",
                    "last_name": "doe",
                    "id": "1234441",
                    "max_children": "0",
                    "numberofguests": "2",
                    "numberofchildren": "0",
                    "numberofadults": "2",
                    "child_age": "10, 15, 16",
                    "roomstaystatus": "new",
                    "roomreservation_id": "1753251542694",
                    "totalbeforetax": "1376",
                    "totaltax": "376",
                    "totalprice": "1752",
                    "price": [
                        {
                            "date": "2025-08-14",
                            "rate_id": "BAR",
                            "mealplan_id": "1",
                            "mealplan": "All inclusive",
                            "tax": "323",
                            "pricebeforetax": "1351",
                            "priceaftertax": "1674"
                        }
                    ],
                    "adults": [],
                    "addons": [
                            {
                                "name": "Full English Breakfast (GBP 16.00, 2 persons x 1 nights)",
                                "nights": "",
                                "priceperunit": "16",
                                "pricemode": "",
                                "price": "32",
                                "comment": "",
                                "pricebeforetax": "32",
                                "tax": "0",
                                "taxes": [],
                                "ota_addon_id": "158329674696934"
                            }
                        ],
                    "extracomponents": [
                        {
                            "name": "test",
                            "value": "78",
                            "taxes": [
                                {
                                    "name": "GST",
                                    "value": "3"
                                },
                                {
                                    "name": "New sales",
                                    "value": "50"
                                }
                            ]
                        }
                    ],
                    "smoking_preference": "",
                    "booking_condition": "",
                    "promotion": "",
                    "mealplan": "",
                    "cancellation_penalties": []
                }
            ],
            "affiliation": {
                "pos": "mybookingsite.io",
                "source": "Meta Channel",
                "OTA_Code": "275",
                "companyname": "",
                "gstno": "",
                "companyaddress": "",
                "companyemail": "[e-mail],[e-mail]" 
            },
            "chain_id": "TPBE",
            "external_id": "",
            "otadue": "",
            "cancelreason": "",
            "sellamount": "2095",
            "nettamount": "2095",
            "discount": "",
            "confirmationlink": "",
            "payment_charge": "",
            "booker_genius": "no",
            "smoking_preference": "",
            "promotion": "",
            "channel_booking_id": "175325152113928",
            "thread_id": "",
            "guest_id": "",
            "numberofpets": "",
            "numberofinfants": "",
            "listingbaseprice": "",
            "processed_at": "2025-07-23 06:18:59",
            "bookingcharged": "N",
            "amountcharged": "0.00",
            "pgtransactionid": "",
            "su_payments": {
                "action": "",
                "tokenid": "",
                "pgid": ""
            },
            "deposit": "",
            "cvv_available": "false",
            "source": "Su",
            "pg_refid": "DirectConfimation1753251523",
            "pg_type": "",
            "cancellation_fee": "",
            "vendor_booking_id": "",
            "id": "175325152113928_TPBE",
            "reservation_notif_id": "175325153100890355556",
            "modified_at": "2025-07-23 06:18:41",
            "status": "new",
            "totalprice": "2095",
            "totaltax": "323.00",
            "extrafees": [
                {
                    "name": "SGST",
                    "amount": "315.00"
                },
                {
                    "name": "CGST",
                    "amount": "28.00"
                }
            ],
            "taxes": []
        }
    ]
}

---

Response Model — Modified Reservation

Sample Success Response

{
    "reservations": [
        {
            "booked_at": "2025-07-23 06:18:41",
            "commissionamount": "",
            "currencycode": "NZD",
            "paymenttype": "Hotel Collect",
            "hotel_id": "TPBE",
            "hotel_name": "TPBE",
            "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": "",
                "cc_cvc": "",
                "cc_expiration_date": "",
                "cc_name": "",
                "cc_number": "",
                "cc_type": "",
                "cc_current_balance": "",
                "cc_activation_date": "",
                "vcc_expiration_date": "",
                "cc_token": "",
                "cc_token_expiration": "",
                "cc_unique_code": "",
                "city": "",
                "state": "",
                "countrycode": "IN",
                "email": "[e-mail]",
                "first_name": " john",
                "last_name": "doe",
                "remarks": " booking_fees :: 315.00 ||  booking_fees :: 28.00",
                "telephone": "[phone]",
                "zip": "",
                "cc_vault_token": "",
                "cc_tracking_id": "",
                "tokensource": "",
                "tokentype": "",
                "token_id": "",
                "cc_virtual": "0"
            },
            "rooms": [
                {
                    "arrival_date": "2025-08-14",
                    "departure_date": "2025-08-15",
                    "info": "",
                    "facilities": "",
                    "taxes": [
                        {
                            "name": "GST",
                            "value": "135.00"
                        },
                        {
                            "name": "Credit card fee (2.8%)",
                            "value": "38.00"
                        },
                        {
                            "name": "New sales",
                            "value": "50.00"
                        },
                        {
                            "name": "TAX",
                            "value": "100.00"
                        }
                    ],
                    "specialrequest": "",
                    "eta": "01:30 am",
                    "guest_name": "john doe",
                    "first_name": "john",
                    "last_name": "doe",
                    "id": "1234441",
                    "max_children": "0",
                    "numberofguests": "2",
                    "numberofchildren": "0",
                    "numberofadults": "2",
                    "child_age": "10, 15, 16",
                    "roomstaystatus": "new",
                    "roomreservation_id": "1753251542694",
                    "totalbeforetax": "1376",
                    "totaltax": "376",
                    "totalprice": "1752",
                    "price": [
                        {
                            "date": "2025-08-14",
                            "rate_id": "BAR",
                            "mealplan_id": "1",
                            "mealplan": "All inclusive",
                            "tax": "323",
                            "pricebeforetax": "1351",
                            "priceaftertax": "1674"
                        }
                    ],
                    "adults": [],
                    "addons": [
                            {
                                "name": "Full English Breakfast (GBP 16.00, 2 persons x 1 nights)",
                                "nights": "",
                                "priceperunit": "16",
                                "pricemode": "",
                                "price": "32",
                                "comment": "",
                                "pricebeforetax": "32",
                                "tax": "0",
                                "taxes": [],
                                "ota_addon_id": "158329674696934"
                            }
                        ],
                    "extracomponents": [
                        {
                            "name": "test",
                            "value": "78",
                            "taxes": [
                                {
                                    "name": "GST",
                                    "value": "3"
                                },
                                {
                                    "name": "New sales",
                                    "value": "50"
                                }
                            ]
                        }
                    ],
                    "smoking_preference": "",
                    "booking_condition": "",
                    "promotion": "",
                    "mealplan": "",
                    "cancellation_penalties": []
                }
            ],
            "affiliation": {
                "pos": "mybookingsite.io",
                "source": "Meta Channel",
                "OTA_Code": "275",
                "companyname": "",
                "gstno": "",
                "companyaddress": "",
                "companyemail": "[e-mail],[e-mail]" 
            },
            "chain_id": "TPBE",
            "external_id": "",
            "otadue": "",
            "cancelreason": "",
            "sellamount": "2095",
            "nettamount": "2095",
            "discount": "",
            "confirmationlink": "",
            "payment_charge": "",
            "booker_genius": "no",
            "smoking_preference": "",
            "promotion": "",
            "channel_booking_id": "175325152113928",
            "thread_id": "",
            "guest_id": "",
            "numberofpets": "",
            "numberofinfants": "",
            "listingbaseprice": "",
            "processed_at": "2025-07-23 06:18:59",
            "bookingcharged": "N",
            "amountcharged": "0.00",
            "pgtransactionid": "",
            "su_payments": {
                "action": "",
                "tokenid": "",
                "pgid": ""
            },
            "deposit": "",
            "cvv_available": "false",
            "source": "Su",
            "pg_refid": "DirectConfimation1753251523",
            "pg_type": "",
            "cancellation_fee": "",
            "vendor_booking_id": "",
            "id": "175325152113928_TPBE",
            "reservation_notif_id": "175325153100890355556",
            "modified_at": "2025-07-23 06:18:41",
            "status": "modified",
            "totalprice": "2095",
            "totaltax": "323.00",
            "extrafees": [
                {
                    "name": "SGST",
                    "amount": "315.00"
                },
                {
                    "name": "CGST",
                    "amount": "28.00"
                }
            ],
            "taxes": []
        }
    ]
}

---

Response Model — Request Booking

Sample Success Response

{
    "reservations": [
        {
            "booked_at": "2025-07-23 06:18:41",
            "commissionamount": "",
            "currencycode": "NZD",
            "paymenttype": "Hotel Collect",
            "hotel_id": "TPBE",
            "hotel_name": "TPBE",
            "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": "",
                "cc_cvc": "",
                "cc_expiration_date": "",
                "cc_name": "",
                "cc_number": "",
                "cc_type": "",
                "cc_current_balance": "",
                "cc_activation_date": "",
                "vcc_expiration_date": "",
                "cc_token": "",
                "cc_token_expiration": "",
                "cc_unique_code": "",
                "city": "",
                "state": "",
                "countrycode": "IN",
                "email": "[e-mail]",
                "first_name": " john",
                "last_name": "doe",
                "remarks": " booking_fees :: 315.00 ||  booking_fees :: 28.00",
                "telephone": "[phone]",
                "zip": "",
                "guest_lang": "en",
                "cc_vault_token": "",
                "cc_tracking_id": "",
                "tokensource": "",
                "tokentype": "",
                "token_id": "",
                "cc_virtual": "0"
            },
            "rooms": [
                {
                    "arrival_date": "2025-08-14",
                    "departure_date": "2025-08-15",
                    "info": "",
                    "facilities": "",
                    "taxes": [
                        {
                            "name": "GST",
                            "value": "135.00"
                        },
                        {
                            "name": "Credit card fee (2.8%)",
                            "value": "38.00"
                        },
                        {
                            "name": "New sales",
                            "value": "50.00"
                        },
                        {
                            "name": "TAX",
                            "value": "100.00"
                        }
                    ],
                    "specialrequest": "",
                    "eta": "01:30 am",
                    "guest_name": "john doe",
                    "first_name": "john",
                    "last_name": "doe",
                    "id": "1234441",
                    "max_children": "0",
                    "numberofguests": "2",
                    "numberofchildren": "0",
                    "numberofadults": "2",
                    "child_age": "10, 15, 16",
                    "roomstaystatus": "new",
                    "roomreservation_id": "1753251542694",
                    "totalbeforetax": "1376",
                    "totaltax": "376",
                    "totalprice": "1752",
                    "price": [
                        {
                            "date": "2025-08-14",
                            "rate_id": "BAR",
                            "mealplan_id": "1",
                            "mealplan": "All inclusive",
                            "tax": "323",
                            "pricebeforetax": "1351",
                            "priceaftertax": "1674"
                        }
                    ],
                    "adults": [],
                    "addons": [
                            {
                                "name": "Full English Breakfast (GBP 16.00, 2 persons x 1 nights)",
                                "nights": "",
                                "priceperunit": "16",
                                "pricemode": "",
                                "price": "32",
                                "comment": "",
                                "pricebeforetax": "32",
                                "tax": "0",
                                "taxes": [],
                                "ota_addon_id": "158329674696934"
                            }
                        ],
                    "extracomponents": [
                        {
                            "name": "test",
                            "value": "78",
                            "taxes": [
                                {
                                    "name": "GST",
                                    "value": "3"
                                },
                                {
                                    "name": "New sales",
                                    "value": "50"
                                }
                            ]
                        }
                    ],
                    "smoking_preference": "",
                    "booking_condition": "",
                    "promotion": "",
                    "mealplan": "",
                    "cancellation_penalties": []
                }
            ],
            "affiliation": {
                "pos": "mybookingsite.io",
                "source": "Meta Channel",
                "OTA_Code": "275",
                "companyname": "",
                "gstno": "",
                "companyaddress": "",
                "companyemail": "[e-mail],[e-mail]" 
            },
            "chain_id": "TPBE",
            "external_id": "",
            "otadue": "",
            "cancelreason": "",
            "sellamount": "2095",
            "nettamount": "2095",
            "discount": "",
            "confirmationlink": "xxxxx.suissu.com/SUAPI/service/requesturls/1-TDhKTFbhp5pm-ulH7VrIUsPOD4qkRO0",
            "payment_charge": "",
            "booker_genius": "no",
            "smoking_preference": "",
            "promotion": "",
            "channel_booking_id": "175325152113928",
            "thread_id": "",
            "guest_id": "",
            "numberofpets": "",
            "numberofinfants": "",
            "listingbaseprice": "",
            "processed_at": "2025-07-23 06:18:59",
            "bookingcharged": "N",
            "amountcharged": "0.00",
            "pgtransactionid": "",
            "su_payments": {
                "action": "",
                "tokenid": "",
                "pgid": ""
            },
            "deposit": "",
            "cvv_available": "false",
            "source": "Su",
            "pg_refid": "DirectConfimation1753251523",
            "pg_type": "",
            "cancellation_fee": "",
            "vendor_booking_id": "",
            "id": "175325152113928_TPBE",
            "reservation_notif_id": "175325153100890355556",
            "modified_at": "2025-07-23 06:18:41",
            "status": "request",
            "totalprice": "2095",
            "totaltax": "323.00",
            "extrafees": [
                {
                    "name": "SGST",
                    "amount": "315.00"
                },
                {
                    "name": "CGST",
                    "amount": "28.00"
                }
            ],
            "taxes": []
        }
    ]
}

---

Response Model - Cancelled Reservation

{
    "reservations": [
        {
            "booked_at": "2025-07-23 06:18:41",
            "commissionamount": "",
            "currencycode": "NZD",
            "paymenttype": "Hotel Collect",
            "hotel_id": "TPBE",
            "hotel_name": "TPBE",
            "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": "",
                "cc_cvc": "",
                "cc_expiration_date": "",
                "cc_name": "",
                "cc_number": "",
                "cc_type": "",
                "cc_current_balance": "",
                "cc_activation_date": "",
                "vcc_expiration_date": "",
                "cc_token": "",
                "cc_token_expiration": "",
                "cc_unique_code": "",
                "city": "",
                "state": "",
                "countrycode": "IN",
                "email": "[e-mail]",
                "first_name": " john",
                "last_name": "doe",
                "remarks": " booking_fees :: 315.00 ||  booking_fees :: 28.00",
                "telephone": "[phone]",
                "zip": "",
                "guest_lang": "en",
                "cc_vault_token": "",
                "cc_tracking_id": "",
                "tokensource": "",
                "tokentype": "",
                "token_id": "",
                "cc_virtual": "0"
            },
            "rooms": [
                {
                    "arrival_date": "2025-08-14",
                    "departure_date": "2025-08-15",
                    "info": "",
                    "facilities": "",
                    "taxes": [
                        {
                            "name": "GST",
                            "value": "135.00"
                        },
                        {
                            "name": "Credit card fee (2.8%)",
                            "value": "38.00"
                        },
                        {
                            "name": "New sales",
                            "value": "50.00"
                        },
                        {
                            "name": "TAX",
                            "value": "100.00"
                        }
                    ],
                    "specialrequest": "",
                    "eta": "01:30 am",
                    "guest_name": "john doe",
                    "first_name": "john",
                    "last_name": "doe",
                    "id": "1234441",
                    "max_children": "0",
                    "numberofguests": "2",
                    "numberofchildren": "0",
                    "numberofadults": "2",
                    "child_age": "10, 15, 16",
                    "roomstaystatus": "cancelled",
                    "roomreservation_id": "1753251542694",
                    "totalbeforetax": "1376",
                    "totaltax": "376",
                    "totalprice": "1752",
                    "price": [
                        {
                            "date": "2025-08-14",
                            "rate_id": "BAR",
                            "mealplan_id": "1",
                            "mealplan": "All inclusive",
                            "tax": "323",
                            "pricebeforetax": "1351",
                            "priceaftertax": "1674"
                        }
                    ],
                    "adults": [],
                    "addons": [
                            {
                                "name": "Full English Breakfast (GBP 16.00, 2 persons x 1 nights)",
                                "nights": "",
                                "priceperunit": "16",
                                "pricemode": "",
                                "price": "32",
                                "comment": "",
                                "pricebeforetax": "32",
                                "tax": "0",
                                "taxes": [],
                                "ota_addon_id": "158329674696934"
                            }
                        ],
                    "extracomponents": [
                        {
                            "name": "test",
                            "value": "78",
                            "taxes": [
                                {
                                    "name": "GST",
                                    "value": "3"
                                },
                                {
                                    "name": "New sales",
                                    "value": "50"
                                }
                            ]
                        }
                    ],
                    "smoking_preference": "",
                    "booking_condition": "",
                    "promotion": "",
                    "mealplan": "",
                    "cancellation_penalties": []
                }
            ],
            "affiliation": {
                "pos": "mybookingsite.io",
                "source": "Meta Channel",
                "OTA_Code": "275",
                "companyname": "",
                "gstno": "",
                "companyaddress": "",
                "companyemail": "[e-mail],[e-mail]" 
            },
            "chain_id": "TPBE",
            "external_id": "",
            "otadue": "",
            "cancelreason": "I made a mistake with the booking dates and need to cancel my reservation.",
            "sellamount": "2095",
            "nettamount": "2095",
            "discount": "",
            "confirmationlink": "xxxxx.suissu.com/SUAPI/service/requesturls/1-TDhKTFbhp5pm-ulH7VrIUsPOD4qkRO0",
            "payment_charge": "",
            "booker_genius": "no",
            "smoking_preference": "",
            "promotion": "",
            "channel_booking_id": "175325152113928",
            "thread_id": "",
            "guest_id": "",
            "numberofpets": "",
            "numberofinfants": "",
            "listingbaseprice": "",
            "processed_at": "2025-07-23 06:18:59",
            "bookingcharged": "N",
            "amountcharged": "0.00",
            "pgtransactionid": "",
            "su_payments": {
                "action": "",
                "tokenid": "",
                "pgid": ""
            },
            "deposit": "",
            "cvv_available": "false",
            "source": "Su",
            "pg_refid": "DirectConfimation1753251523",
            "pg_type": "",
            "cancellation_fee": "",
            "vendor_booking_id": "",
            "id": "175325152113928_TPBE",
            "reservation_notif_id": "175325153100890355556",
            "modified_at": "2025-07-23 06:18:41",
            "status": "cancelled",
            "totalprice": "2095",
            "totaltax": "323.00",
            "extrafees": [
                {
                    "name": "SGST",
                    "amount": "315.00"
                },
                {
                    "name": "CGST",
                    "amount": "28.00"
                }
            ],
            "taxes": []
        }
    ]
}

Response Model — Multiple Room Reservation

Sample Success Response

{
    "reservations": [
        {
            "booked_at": "2025-07-23 06:37:31",
            "commissionamount": "",
            "currencycode": "NZD",
            "paymenttype": "Hotel Collect",
            "hotel_id": "TPBE",
            "hotel_name": "TPBE",
            "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": "",
                "cc_cvc": "",
                "cc_expiration_date": "",
                "cc_name": "",
                "cc_number": "",
                "cc_type": "",
                "cc_current_balance": "",
                "cc_activation_date": "",
                "vcc_expiration_date": "",
                "cc_token": "",
                "cc_token_expiration": "",
                "cc_unique_code": "",
                "city": "",
                "state": "",
                "countrycode": "IN",
                "email": "[e-mail]",
                "first_name": " john",
                "last_name": "doe",
                "remarks": " booking_fees :: 566.00 ||  booking_fees :: 28.00",
                "telephone": "[phone]",
                "zip": "",
                "guest_lang": "en",
                "cc_vault_token": "",
                "cc_tracking_id": "",
                "tokensource": "",
                "tokentype": "",
                "token_id": "",
                "cc_virtual": "0"
            },
            "rooms": [
                {
                    "arrival_date": "2025-08-14",
                    "departure_date": "2025-08-15",
                    "info": "",
                    "facilities": "",
                    "taxes": [
                        {
                            "name": "GST",
                            "value": "135.00"
                        },
                        {
                            "name": "Credit card fee (2.8%)",
                            "value": "38.00"
                        },
                        {
                            "name": "New sales",
                            "value": "50.00"
                        },
                        {
                            "name": "TAX",
                            "value": "100.00"
                        }
                    ],
                    "specialrequest": "",
                    "eta": "01:30 am",
                    "guest_name": "john doe",
                    "first_name": "john",
                    "last_name": "doe",
                    "id": "1234441",
                    "max_children": "0",
                    "numberofguests": "2",
                    "numberofchildren": "0",
                    "numberofadults": "2",
                    "child_age": "10, 15, 16",
                    "roomstaystatus": "new",
                    "roomreservation_id": "1753252672384",
                    "totalbeforetax": "1376",
                    "totaltax": "376",
                    "totalprice": "1752",
                    "price": [
                        {
                            "date": "2025-08-14",
                            "rate_id": "BAR",
                            "mealplan_id": "1",
                            "mealplan": "All inclusive",
                            "tax": "323",
                            "pricebeforetax": "1351",
                            "priceaftertax": "1674"
                        }
                    ],
                    "adults": [],
                    "addons": [
                            {
                                "name": "Full English Breakfast (GBP 16.00, 2 persons x 1 nights)",
                                "nights": "",
                                "priceperunit": "16",
                                "pricemode": "",
                                "price": "32",
                                "comment": "",
                                "pricebeforetax": "32",
                                "tax": "0",
                                "taxes": [],
                                "ota_addon_id": "158329674696934"
                            }
                        ],
                    "extracomponents": [
                        {
                            "name": "test",
                            "value": "78",
                            "taxes": [
                                {
                                    "name": "GST",
                                    "value": "3"
                                },
                                {
                                    "name": "New sales",
                                    "value": "50"
                                }
                            ]
                        }
                    ],
                    "smoking_preference": "",
                    "booking_condition": "",
                    "promotion": "",
                    "mealplan": "",
                    "cancellation_penalties": []
                },
                {
                    "arrival_date": "2025-08-14",
                    "departure_date": "2025-08-15",
                    "info": "",
                    "facilities": "",
                    "taxes": [
                        {
                            "name": "GST",
                            "value": "110.00"
                        },
                        {
                            "name": "Credit card fee (2.8%)",
                            "value": "31.00"
                        },
                        {
                            "name": "New sales",
                            "value": "50.00"
                        },
                        {
                            "name": "TAX",
                            "value": "100.00"
                        }
                    ],
                    "specialrequest": "",
                    "eta": "01:30 am",
                    "guest_name": "John Doe",
                    "first_name": "John",
                    "last_name": "Doe",
                    "id": "123444",
                    "max_children": "0",
                    "numberofguests": "1",
                    "numberofchildren": "0",
                    "numberofadults": "1",
                    "child_age": "10, 15, 16",
                    "roomstaystatus": "new",
                    "roomreservation_id": "1753252676277",
                    "totalbeforetax": "1100",
                    "totaltax": "291",
                    "totalprice": "1391",
                    "price": [
                        {
                            "date": "2025-08-14",
                            "rate_id": "BAR",
                            "mealplan_id": "1",
                            "mealplan": "All inclusive",
                            "tax": "291",
                            "pricebeforetax": "1100",
                            "priceaftertax": "1391"
                        }
                    ],
                    "adults": [],
                    "addons": [
                            {
                                "name": "Full English Breakfast (GBP 16.00, 2 persons x 1 nights)",
                                "nights": "",
                                "priceperunit": "16",
                                "pricemode": "",
                                "price": "32",
                                "comment": "",
                                "pricebeforetax": "32",
                                "tax": "0",
                                "taxes": [],
                                "ota_addon_id": "158329674696934"
                            }
                        ],
                    "extracomponents": [],
                    "smoking_preference": "",
                    "booking_condition": "",
                    "promotion": "",
                    "mealplan": "",
                    "cancellation_penalties": []
                }
            ],
            "affiliation": {
                "pos": "mybookingsite.io",
                "source": "Meta Channel",
                "OTA_Code": "275",
                "companyname": "",
                "gstno": "",
                "companyaddress": "",
                "companyemail": "[e-mail],[e-mail]" 
            },
            "chain_id": "TPBE",
            "external_id": "",
            "otadue": "",
            "cancelreason": "",
            "sellamount": "3737",
            "nettamount": "3737",
            "discount": "",
            "confirmationlink": "",
            "payment_charge": "",
            "booker_genius": "no",
            "smoking_preference": "",
            "promotion": "",
            "channel_booking_id": "175325265161721",
            "thread_id": "",
            "guest_id": "",
            "numberofpets": "",
            "numberofinfants": "",
            "listingbaseprice": "",
            "processed_at": "2025-07-23 06:37:50",
            "bookingcharged": "N",
            "amountcharged": "0.00",
            "pgtransactionid": "",
            "su_payments": {
                "action": "",
                "tokenid": "",
                "pgid": ""
            },
            "deposit": "",
            "cvv_available": "false",
            "source": "Su",
            "pg_refid": "DirectConfimation1753252654",
            "pg_type": "",
            "cancellation_fee": "",
            "vendor_booking_id": "",
            "id": "175325265161721_TPBE",
            "reservation_notif_id": "175325266175217432335",
            "modified_at": "2025-07-23 06:37:31",
            "status": "new",
            "totalprice": "3737",
            "totaltax": "614.00",
            "extrafees": [
                {
                    "name": "SGST",
                    "amount": "566.00"
                },
                {
                    "name": "CGST",
                    "amount": "28.00"
                }
            ],
            "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"
  }
}