Sample Recheck Response

Main Response Object

Attribute Type Description
search_id string Unique identifier referencing the previous search request used for re-check.
hotel Hotel Contains complete hotel details, rate breakdown, policies, pricing, and metadata.
cp_changed boolean This flag indicates whether the cancellation policy has changed between the search and recheck response
price_changed boolean This flag indicates whether the hotel price returned during recheck differs from the price shown during the initial search

Hotel

Attribute Type Description
name string Hotel name.
hotel_code string Internal supplier/OTA hotel identifier.
images object HotelImages Image URLs for hotel display.
geolocation GeoLocation Hotel latitude and longitude.
facilities string Combined hotel facility list (raw HTML/text).
description string Hotel description (may contain HTML).
country string Country code of the hotel.
city_code string City identification code.
category number Star rating category.
address string Full formatted hotel address.
acc_type string Accommodation type code.
safe2stay Safe2Stay COVID-19 / hygiene compliance information.
rate Rate Complete rate information including pricing, room structure, cancellation rules, promotions.

Safe2Stay

Attribute Type Description
covid_19_safety_protocol string Description of COVID safety protocol (HTML formatted).
covid_19_safe_to_stay string Indicates if property is certified safe to stay (Y/N).

Rate

Attribute Type Description
supports_cancellation boolean Indicates if cancellation is allowed.
supports_amendment boolean Indicates if changes are allowed after booking.
rooms Room[] List of rooms included in the booking.
room_code string Supplier room code reference.
rate_type string Type of rate (e.g., bookable, requestable).
rate_key string Unique key required for booking validation.
rate_comments RateComments Additional booking-related instructions in key value pairs
promotions_details string[] List of applied promotions or membership benefits.
price_details PriceDetails Breakdown of pricing structure including taxes and totals.
price float Final total price to be charged.
payment_type string[] Allowed payment methods (e.g., AT_WEB).
other_inclusions string[] Additional services bundled in rate (WiFi, parking).
non_refundable boolean Indicates if the rate is fully non-refundable.
no_of_rooms number Number of rooms booked.
includes_boarding boolean Indicates if boarding/meals included.
has_promotions boolean Whether promotions apply.
group_code string Supplier / OTA group code identifier.
currency string Currency of rate.
credit_deduction string When the credit/payment is deducted (immediate, at check-in, etc).
cancellation_policy CancellationPolicy Detailed cancellation rules and penalties.
boarding_details string[] Included meal or boarding plan.

Room

Attribute Type Description
room_type string Full display room title.
room_reference string Unique reference used while booking.
no_of_rooms number Count of rooms booked.
no_of_children number Number of children.
no_of_adults number Number of adults.
description string Room description including meal plan, amenities, etc.

RateComments

Here, the attribute column can have more number of keys depending on the hotel, but following ones are standard.

Attribute Type Description
pax_comments string Special processing conditions related to guests (e.g., infant rules).
mealplan string Meal plan details.
comments string Additional tax or policy notes.

PriceDetails

Attribute Type Description
surcharge_or_tax PriceComponent[] Taxes, service fees, or mandatory charges.
net PriceComponent[] Base price components.
GST PriceComponent[] Government tax items.

PriceComponent

Attribute Type Description
name string Charge / tax / fare component name.
included boolean Whether this component is included in final price.
currency string Currency code.
amount_type string Value type: fixed value, percent, or nightly.
amount float Price amount.

CancellationPolicy

Attribute Type Description
under_cancellation boolean Whether booking is already in cancellation window.
no_show_fee CancelFee Penalty charged for no-show.
details CancelRule[] List of cancellation penalty rules with dates.
cancel_by_date string (ISODateTime) Last date to cancel without penalty.
amount_type string Type of rule (value/percent/nights).

CancelFee

Percent Type

Attribute Type Description
percent number Percent charged as penalty.
currency string Currency of penalty.
amount_type string The amount type charged: enum(flat_fee nights percent)

Example

...

"no_show_fee": {
    "percent": 100,
    "currency": "INR",
    "amount_type": "percent"
},

...

Value Type

Attribute Type Description
flat_fee number The flat amount charged as penalty.
currency string Currency of penalty.
amount_type string The amount type charged: enum(value nights percent)

Example:

...

"no_show_fee": {
    "amount_type": "value",
    "currency": "INR",
    "flat_fee": 95700
},
...
Attribute Type Description
nights number The number of nights charged as penalty.
currency string Currency of penalty.
amount_type string The amount type charged: enum(value nights percent)

Example

...

 "no_show_fee": {
    "nights": 1,
    "currency": "INR",
    "amount_type": "nights"
},

...

CancelRule

Can be one of the following

Attribute Type Description
value number number of nights charged if cancelled after from.
from string (ISODateTime) Date-time after which penalty applies.
currency string Currency of penalty.
Attribute Type Description
percent number Percentage charged if cancelled after from.
from string (ISODateTime) Date-time after which penalty applies.
currency string Currency of penalty.
Attribute Type Description
nights number number of nights charged if cancelled after from.
from string (ISODateTime) Date-time after which penalty applies.
currency string Currency of penalty.

HotelImages

Attribute Type Description
url string General hotel image URL.
main_image string Primary cover image.

GeoLocation

Attribute Type Description
latitude number Latitude of hotel.
longitude number Longitude of hotel.

Sample Response

{
  "cp_changed": false,
  "price_changed": false,
  "search_id": "j7bbfukkdqbp5rscizb3u7pspu",
  "hotel": {
    "safe2stay": {
      "covid_19_safety_protocol": "This property advises that enhanced cleaning and guest safety measures are currently in place.<br>Property is officially certified under regional sanitization guidelines.<br>",
      "covid_19_safe_to_stay": "Y"
    },
    "rate": {
      "supports_cancellation": true,
      "supports_amendment": false,
      "rooms": [
        {
          "room_type": "The Pillars Executive Studio Residences (1 Double Bed)",
          "room_reference": "4pcf5nb45arcpwcruwowiho743kkls5k6o6o5udr3rbba",
          "no_of_rooms": 1,
          "no_of_children": 0,
          "no_of_adults": 2,
          "description": "The Pillars Executive Studio Residences (1 Double Bed) : Free breakfast"
        }
      ],
      "room_code": "4dffdmrv7qvspubi3l4w2f6x4tl2tqvw6c76pudr3naqn77c",
      "rate_type": "bookable",
      "rate_key": "4dfvzmj74uws3uc3u2nwmg6v4dn2tr5c7g363w333fgr76xcddmxzahseifq",
      "rate_comments": {
        "policies": "No pets and no service animals are allowed at this property.",
        "pax_comments": "For this rate the infants will be converted to children with age 1.",
        "mealplan": "Free breakfast",
        "comments": "Tax / Fee like Resort fee or any other taxes that are directly payable to the Hotel",
        "checkout_time": "12:00 PM",
        "checkin_special_instructions": "Front desk staff will greet guests on arrival.",
        "checkin_min_age": "18",
        "checkin_instructions": "<ul>  <li>Extra-person charges may apply and vary depending on property policy</li><li>Government-issued photo identification and a credit card",
        "checkin_end_time": "anytime",
        "checkin_begin_time": "3:00 PM"
      },
      "promotions_details": ["Member’s price: 30%"],
      "price_details": {
        "surcharge_or_tax": [
          {
            "name": "Tax recovery charges and Service fees (Sales Tax)",
            "included": true,
            "currency": "INR",
            "amount_type": "value",
            "amount": 2190.06
          }
        ],
        "net": [
          {
            "name": "SupplierPrice",
            "included": true,
            "currency": "INR",
            "amount_type": "value",
            "amount": 14563.3
          },
          {
            "name": "ServiceFee",
            "included": true,
            "currency": "INR",
            "amount_type": "value",
            "amount": 582.53
          },
          {
            "name": "Total",
            "included": true,
            "currency": "INR",
            "amount_type": "value",
            "amount": 15145.83
          }
        ],
        "GST": [
          {
            "name": "Total",
            "included": true,
            "currency": "INR",
            "amount_type": "value",
            "amount": 104.86
          }
        ]
      },
      "price": 15251,
      "payment_type": ["AT_WEB"],
      "other_inclusions": ["Free WiFi", "Free self parking"],
      "non_refundable": false,
      "no_of_rooms": 1,
      "includes_boarding": true,
      "has_promotions": true,
      "group_code": "wsdbjylcxn4ufgaa4tbdgf644hl2prfb6syo2",
      "currency": "INR",
      "credit_deduction": "immediate",
      "cancellation_policy": {
        "under_cancellation": false,
        "no_show_fee": {
          "percent": 100,
          "currency": "INR",
          "amount_type": "percent"
        },
        "details": [
          {
            "percent": 100,
            "from": "2022-06-26T18:00:00",
            "currency": "INR"
          }
        ],
        "cancel_by_date": "2022-06-26T17:59:59",
        "amount_type": "percent"
      },
      "boarding_details": ["Free breakfast"],
      "availability_status": "available"
    },
    "name": "137 Pillars Residences",
    "images": {
      "url": "",
      "main_image": ""
    },
    "hotel_code": "1796166",
    "geolocation": {
      "longitude": 100.57237,
      "latitude": 13.73752
    },
    "facilities": "Air conditioning ; Lounges/bars ; ",
    "description": "<p><b>Property Location</b> <br />Located in Bangkok (Sukhumvit), 137 Pillars Residences Bangkok is within a 15-minute walk of EmQuartier and Emporium",
    "country": "TH",
    "city_code": "122861",
    "category": 5,
    "address": "38 Sukhumvit Soi 39, Klongton-Nua, Wattana, Bangkok 10110",
    "acc_type": "0"
  }
}