Room Availibility

Returns rates and availability on all room types for specified properties. Multiple rooms of the same type may be requested by including multiple instances of the occupancy parameter. No more than 8 rooms may be requested at a time - if you need to book more than 8 rooms at once, please consult with your account manager about our group booking partnership.

Parameters

Name

Description

Accept

string

( header )

Must be application/json

Accept - Encoding

string

( header )

Must be gzip

Authorization

string

( header )

Must be Your API Key

Customer-Ip

string

( header )

Must be IP address of the customer, as captured by your integration. Send IPV4 addresses only.

Ensure your integration passes the customer’s IP, not your own. This value helps determine their location and other settings.

Also used for fraud recovery and other important analytics.

action

string

( query )

Must be "hotelRoomAvailability" as parameter

Action methods in Web API controller can have one or more parameters of different types. It can be either primitive type or complex type. Web API binds action method parameters either with URL's query string or with request body depending on the parameter type.

apiKey

string

( query )

Must be a valid API Key

The API Key provided to you is critical to the security of your request data – treat it like a password. Never include the raw value in any publicly accessible site or app code. You will be provided with an API key when you are approved to integrate TPS API.

ModeType

string

( query )

Must be either "Test" or "LIVE"

Your application must be approved from Adivaha Personnel. All the transactions will be treated as LIVE once the parameter is set to LIVE.

requestBody

array

( query )

Must be an array with the following parameters

hotelId

string

( query )

The ID of the property you want to gather information for.

checkIn

string

( query )

The date by which a guest must check in. Must follow YYYY-MM-DD format. ie. "checkIn:2019-05-30"

checkOut

string

( query )

The date by which a guest must check out. Must follow YYYY-MM-DD format. ie. "checkIn:2019-05-31"

rooms

number

( query )

Number of rooms to be set for the search, can be between 1-7

adults

number

( query )

Number of adults to be set for the search, can be between 1-4

children

number

( query )

Number of children to be set for the search, can be between 1-2

REQUEST

API Endpoint: https://travelbeesapi.com/webServices/hotels/v2-sandbox/api.php

header: array(
'Content-Type:application/json',
'Accept-encoding: gzip',
'x-api-key:'ADD-YOUR-KEY'
);

GET: https://travelbeesapi.com/webServices/hotels/v2-sandbox/api.php?action=getLocations&requestBody={"hotelId": 260962,"checkIn": "06/28/2019","checkOut": "06/29/2019","rooms": 1,"adults": 2,"children": 0}
					 

Response

The API returns an HTTP response, which generally includes the result of the request invocation

{
    "status": 200,
    "status_message": "OK",
    "responseData": {
        "size": 3,
        "RoomTypes": [
            {
                "rateCode": 204929105,
                "rateDescription": "Standard Double Room",
                "roomTypeId": "1656337",
                "roomCode": "201012801",
                "description": "Standard Double Room",
                "descriptionLong": "1 Double Bed
2153-sq-foot (200-sq-meter) room with city views

Internet - Free WiFi
Entertainment - LCD television with satellite channels
Food & Drink - Coffee/tea maker, minibar, 24-hour room service, and free bottled water
Bathroom - Private bathroom, shower, slippers, and free toiletries
Practical - Safe, free newspaper, and desk; rollaway/extra beds available on request
Comfort - Air conditioning and daily housekeeping
Smoking/Non Smoking
 ", "smokingPreferences": "E", "averageBaseRate": "71.86", "averageRate": "71.86", "maxNightlyRate": 71.86, "nightlyRateTotal": 71.86, "surchargeTotal": 14.56, "taxRate": null, "total": 86.42, "without_discount_total": 86.42, "averageRate_usd": null, "surchargeTotal_usd": null, "total_usd": null, "cancellationPolicy": "We understand that sometimes your travel plans change. We do not charge a change or cancel fee. However, this property (Hotel Palace Heights) imposes the following penalty to its customers that we are required to pass on: Cancellations or changes made after 5:59 PM ((GMT+05:30)) on Jun 18, 2019 are subject to a 1 Night Room & Tax penalty. If you fail to check-in for this reservation, or if you cancel or change this reservation after check-in, you may incur penalty charges at the discretion of the property of up to 100% of the booking value. ", "roomAmenities": [ { "amenityId": "1", "amenity": "Air conditioning" }, { "amenityId": "132", "amenity": "Coffee/tea maker" }, { "amenityId": "133", "amenity": "Daily housekeeping" }, { "amenityId": "2026", "amenity": "Desk" }, { "amenityId": "2403", "amenity": "Free WiFi" }, { "amenityId": "2057", "amenity": "Free bottled water" }, { "amenityId": "128", "amenity": "Free newspaper" }, { "amenityId": "143", "amenity": "Free toiletries" }, { "amenityId": "144", "amenity": "Hair dryer" }, { "amenityId": "146", "amenity": "In-room safe" }, { "amenityId": "2575", "amenity": "LCD TV" }, { "amenityId": "131", "amenity": "Minibar" }, { "amenityId": "1073743379", "amenity": "Number of bathrooms - 1" }, { "amenityId": "136", "amenity": "Phone" }, { "amenityId": "141", "amenity": "Private bathroom" }, { "amenityId": "1073742816", "amenity": "Rollaway/extra beds (surcharge)" }, { "amenityId": "2015", "amenity": "Room service (24 hours)" }, { "amenityId": "2396", "amenity": "Satellite TV service" }, { "amenityId": "2166", "amenity": "Shower only" }, { "amenityId": "2162", "amenity": "Slippers" }, { "amenityId": "6213", "amenity": "Smoking And Non-Smoking" } ], "BedTypes": [ "" ], "valueAddIds": [ { "id": "2205", "description": "Breakfast Buffet" } ], "nonRefundable": false, "promoDescription": null, "currentAllotment": 4, "RoomImages": "https://adivaha.com/hotels/2000000/1790000/1782800/1782711/24639535_s.jpg" }, { "rateCode": 1937653, "rateDescription": "Deluxe Single Room, 1 Double Bed", "roomTypeId": "586656", "roomCode": "496087", "description": "Deluxe Single Room, 1 Double Bed", "descriptionLong": "1 Double Bed
2691-sq-foot (250-sq-meter) room with city views

Internet - Free WiFi
Entertainment - LCD television with satellite channels
Food & Drink - Coffee/tea maker, minibar, 24-hour room service, and free bottled water
Bathroom - Private bathroom, shower, slippers, and free toiletries
Practical - Safe, free newspaper, and desk; rollaway/extra beds available on request
Comfort - Air conditioning and daily housekeeping
Smoking/Non Smoking
 ", "smokingPreferences": "E", "averageBaseRate": "79.04", "averageRate": "79.04", "maxNightlyRate": 79.04, "nightlyRateTotal": 79.04, "surchargeTotal": 16.02, "taxRate": null, "total": 95.06, "without_discount_total": 95.06, "averageRate_usd": null, "surchargeTotal_usd": null, "total_usd": null, "cancellationPolicy": "We understand that sometimes your travel plans change. We do not charge a change or cancel fee. However, this property (Hotel Palace Heights) imposes the following penalty to its customers that we are required to pass on: Cancellations or changes made after 5:59 PM ((GMT+05:30)) on Jun 18, 2019 are subject to a 1 Night Room & Tax penalty. If you fail to check-in for this reservation, or if you cancel or change this reservation after check-in, you may incur penalty charges at the discretion of the property of up to 100% of the booking value. ", "roomAmenities": [ { "amenityId": "1", "amenity": "Air conditioning" }, { "amenityId": "132", "amenity": "Coffee/tea maker" }, { "amenityId": "133", "amenity": "Daily housekeeping" }, { "amenityId": "2026", "amenity": "Desk" }, { "amenityId": "2403", "amenity": "Free WiFi" }, { "amenityId": "2057", "amenity": "Free bottled water" }, { "amenityId": "128", "amenity": "Free newspaper" }, { "amenityId": "143", "amenity": "Free toiletries" }, { "amenityId": "144", "amenity": "Hair dryer" }, { "amenityId": "146", "amenity": "In-room safe" }, { "amenityId": "2575", "amenity": "LCD TV " }, { "amenityId": "131", "amenity": "Minibar" }, { "amenityId": "1073743379", "amenity": "Number of bathrooms - 1" }, { "amenityId": "136", "amenity": "Phone" }, { "amenityId": "141", "amenity": "Private bathroom" }, { "amenityId": "1073742816", "amenity": "Rollaway/extra beds (surcharge)" }, { "amenityId": "2015", "amenity": "Room service (24 hours)" }, { "amenityId": "2396", "amenity": "Satellite TV service" }, { "amenityId": "2166", "amenity": "Shower only" }, { "amenityId": "2162", "amenity": "Slippers" }, { "amenityId": "6213", "amenity": "Smoking And Non-Smoking" } ], "BedTypes": [ "" ], "valueAddIds": [ { "id": "2192", "description": "Free Wireless Internet" }, { "id": "2205", "description": "Breakfast Buffet" } ], "nonRefundable": false, "promoDescription": null, "currentAllotment": 2, "RoomImages": "https://adivaha.com/hotels/2000000/1790000/1782800/1782711/07555a00_s.jpg" }, { "rateCode": 1937654, "rateDescription": "Deluxe Double Room", "roomTypeId": "586657", "roomCode": "496088", "description": "Deluxe Double Room", "descriptionLong": "1 Double Bed
2153-sq-foot (200-sq-meter) room with city views

Internet - Free WiFi
Entertainment - LCD television with satellite channels
Food & Drink - Coffee/tea maker, minibar, 24-hour room service, and free bottled water
Bathroom - Private bathroom, shower, slippers, and free toiletries
Practical - Safe, free newspaper, and desk; rollaway/extra beds available on request
Comfort - Air conditioning and daily housekeeping
Smoking/Non Smoking
 ", "smokingPreferences": "E", "averageBaseRate": "86.23", "averageRate": "86.23", "maxNightlyRate": 86.23, "nightlyRateTotal": 86.23, "surchargeTotal": 17.47, "taxRate": null, "total": 103.7, "without_discount_total": 103.7, "averageRate_usd": null, "surchargeTotal_usd": null, "total_usd": null, "cancellationPolicy": "We understand that sometimes your travel plans change. We do not charge a change or cancel fee. However, this property (Hotel Palace Heights) imposes the following penalty to its customers that we are required to pass on: Cancellations or changes made after 5:59 PM ((GMT+05:30)) on Jun 18, 2019 are subject to a 1 Night Room & Tax penalty. If you fail to check-in for this reservation, or if you cancel or change this reservation after check-in, you may incur penalty charges at the discretion of the property of up to 100% of the booking value. ", "roomAmenities": [ { "amenityId": "1", "amenity": "Air conditioning" }, { "amenityId": "132", "amenity": "Coffee/tea maker" }, { "amenityId": "133", "amenity": "Daily housekeeping" }, { "amenityId": "2026", "amenity": "Desk" }, { "amenityId": "2403", "amenity": "Free WiFi" }, { "amenityId": "2057", "amenity": "Free bottled water" }, { "amenityId": "128", "amenity": "Free newspaper" }, { "amenityId": "143", "amenity": "Free toiletries" }, { "amenityId": "144", "amenity": "Hair dryer" }, { "amenityId": "146", "amenity": "In-room safe" }, { "amenityId": "2575", "amenity": "LCD TV " }, { "amenityId": "131", "amenity": "Minibar" }, { "amenityId": "1073743379", "amenity": "Number of bathrooms - 1" }, { "amenityId": "136", "amenity": "Phone" }, { "amenityId": "141", "amenity": "Private bathroom" }, { "amenityId": "1073742816", "amenity": "Rollaway/extra beds (surcharge)" }, { "amenityId": "2015", "amenity": "Room service (24 hours)" }, { "amenityId": "2396", "amenity": "Satellite TV service" }, { "amenityId": "2166", "amenity": "Shower only" }, { "amenityId": "2162", "amenity": "Slippers" }, { "amenityId": "6213", "amenity": "Smoking And Non-Smoking" } ], "BedTypes": [ "" ], "valueAddIds": [ { "id": "2192", "description": "Free Wireless Internet" }, { "id": "2205", "description": "Breakfast Buffet" } ], "nonRefundable": false, "promoDescription": null, "currentAllotment": 3, "RoomImages": "https://adivaha.com/hotels/2000000/1790000/1782800/1782711/ce861f5e_s.jpg" } ] } }