Availability

Ways to request availability

Availability can be requested by anyone* of these:

  • Hotel code: Include up to 2,000 hotel codes in the request. 
  • GPS coordinates

Search based on geolocation coordinates. You can do it by either using a circle or a rectangle area:

  • Circle: you must specify longitude, latitude, radius and unit. The first two are used to mark the centre of the circle, while the radius (in km or mi) will determine the area.
  • Rectangle: you must specify longitude, latitude, secondaryLongitude and secondaryLatitude. The first two are the top left corner and the second two are the bottom right corner of the rectangle.

Please, refrain from doing a circle and rectangle GPS search at the same time.

  • Destination or destination and zone

Please note that the recommended search types are by Hotel code and by GPS coordinates. The search by destination or destination/zone will be activated upon request.

*Only one can be used for each request. For example, if you request by hotel code, you cannot include geolocations or destination.

Advanced filters

1- Filter by keyword

List keywords for hotels in the request to receive a response containing the required features/facilities. In some cases, a hotel rating appears in the response.

	<keywords>
		<keyword>34</keyword>
		<keyword>38</keyword>
		<keyword>100</keyword>
	</keywords>

2- Filter by minimum and/or maximum price

Filter the request by the number of hotels, as well as minimum and maximum price.

	<filter minRate="100.000" maxRate="170.000"/>

3- Filter by board code

It is possible to include a list of board codes. The "included" attribute indicates the limitation or the exclusion of the board type from the response. 

	<boards included="true"> 
		<board>RO</board>
		<board>BB</board>
 	</boards>

4- Filter by category

Filters the request using the hotel’s star rating.

	<filter minCategory="3" maxCategory="5"/>

5- Filter by payment type

 Using this node, it is possible to select the payment type.

	<filter paymentType="AT_WEB"/>

6- Filter by accommodation type

(Due an issue, this filter is out of service until 30th September. Refrain from using it since you might lose product) This option filters the request to receive a response featuring the desired accommodation types.

	<accommodations>
		<accommodation>HOTEL</accommodation> 
		<accommodation>HOSTEL</accommodation>
	</accommodations>

7- Filter by review rating 

Filters the request to receive a response containing information on the review rating selected.

	<reviews>
		<review type="TRIPADVISOR" maxRate="5" minReviewCount="3"/>
	</reviews>	

8- Limit the number of rooms per hotel 

This option limits the number of rooms available per hotel.

	<filter maxRooms="2"/>

9- Limit the number of rates per room

The option limits the number of rates received per hotel.

	<filter maxRatesPerRoom="3"/>

10- Filter, add or remove rates for packaging 

The filter is used to indicate if you want to receive rates for packaging or not.

	<filter hotelPackage="yes"/>

11- Filter by room code

Used to only include or exclude specific room code.

	<rooms included="true">
		<room>DBT.ST</room>
	</rooms>

12- Filter by contract

Used to show only results with specific contracts. When CacheAPI clients use this filter it's required to also inform the availabilityRQ/@aifUse attribute.

	<filter contract="CG-FIT B2B"/>

 

ENDPOINT:   POST https://api.test.hotelbeds.com/hotel-api/1.0/hotels

Request parameters

Node/Attribute

Type

Required

Description

availabilityRQ

Element

Required

Top level

availabilityRQ/@dailyRate

Boolean

Optional

Displays daily price breakdown

availabilityRQ/@sourceMarket

String

Optional

Hotelbeds Group client source market

availabilityRQ/@language

String

Optional

Language of the response

availabilityRQ/@aifUse Boolean Optional Tags the request for CacheAPI users (NOTE: MANDATORY for this users when filtering by contract)

availabilityRQ/stay

Element

Required

Booking length of stay element

availabilityRQ/stay/@checkIn

String

Required

Check-in date

The format to be used must be

YYYY-MM-DD

availabilityRQ/stay/@checkOut

String

Required

Check-out date

The format to be used must be

YYYY-MM-DD

availabilityRQ/stay/@shiftDays

Int

Optional

Integer fom 1 to 5

Amount of days after and before the check-in to check availability, keeping the same stay duration

availabilityRQ/stay/@allowOnlyShift Boolean Optional

TRUE = Return shiftDays even if there is no availability for the searched dates (default)

FALSE = If there is no availabilty for the searched dates, do not return any shiftDays.

availabilityRQ/occupancies

Array of occupancy elements

Required

In the occupancy node, the following information must be included:

the number of rooms, capacity, the number of adults, the number of children and their ages, if applicable.

availabilityRQ/occupancies/occupancy

Element

Required

Occupancy element

availabilityRQ/occupancies/occupancy/@rooms

Int

Required

Number of rooms

availabilityRQ/occupancies/occupancy/@adults

Int

Required

Number of adults

availabilityRQ/occupancies/occupancy/@children

Int

Required

Number of children

availabilityRQ/occupancies/occupancy/occupancy/paxes

Element

Optional

Paxes element (mandatory when children are requested)

 

availabilityRQ/occupancies/occupancy/occupancy/paxes/pax/@type

String

Optional

Pax type

AD=Adult

CH=Child

availabilityRQ/occupancies/occupancy/occupancy/paxes/pax/@age

Int

Required

Pax age (required for ages of children)

availabilityRQ/occupancies/occupancy/occupancy/paxes/pax/@name

String

Optional

Pax name

availabilityRQ/occupancies/occupancy/occupancy/paxes/pax/@surname

String

Optional

Pax surname

availabilityRQ/destination/

Element

Optional

Destination element

availabilityRQ/destination/@code

String

Optional

Destination code for hotel location (mandatory if the destination element is used)

availabilityRQ/destination/@zone

Int

Optional

Destination zone for hotel location

availabilityRQ/geolocation

Element

Optional

Geolocation element

availabilityRQ/geolocation/@longitude

Float

Optional

Longitude data for geolocation (mandatory if the geolocation element is used)

availabilityRQ/geolocation/@latitude

Float

Optional

Latitude data for geoloation (mandatory if the geolocation element is used)

availabilityRQ/geolocation/@radius

Int

Optional

Radius of the area circle (mandatory if the geolocation element is used)

availabilityRQ/geolocation/@unit

String

Optional

  • mi Miles
  • km Kilometers

availabilityRQ/geolocation/@secondaryLongitude

Float

Optional

GPS longitude of the bottom right point of the area rectangle

availabilityRQ/geolocation/@secondaryLatitude

Float

Optional

GPS latitude of the bottom right point of the area rectangle

availabilityRQ/keywords

Array of keyword elements

Optional

Array of keyword elements

availabilityRQ/keywords/@allIncluded

Boolean

 

TRUE

FALSE

availabilityRQ/keywords/keyword

String

Optional

Keyword to be searched (mandatory if keywords element is used)

Possible values (use only the number code)

29    Romantic hotels    
31    Design        
34    Business hotels    
36    Golf hotels    
37    Beach hotels    
38    City        
39    Hotels with spa
42    Historical        
43    Ski    hotels    
44    Rural hotels    
45    Sport hotels    
81    Family hotels    
83    Internet        
84    Wheelchair-friendly
85    Restaurant        
86    Spa        
87    Parking        
88    TV        
89    Gym        
90    Air    conditioned    
92    Heating        
100    Hotels with charm
101    Swimming Pool   

availabilityRQ/hotels

Array of hotel elements

Optional

List of hotel elements

availabilityRQ/hotels/hotel

Int

Optional

Internal hotel code (mandatory if the hotels element is used)

availabilityRQ/boards

String

Optional

List of boards to be excluded or included in the response

availabilityRQ/boards/@included

Boolean

Optional

The attribute indicates if the board list values should be excluded or included in the response

(mandatory if the boards element is used)

FALSE: the boards will be excluded from the response

TRUE: the response will return only the boards listed

availabilityRQ/boards/board

String

 

Internal board code (mandatory if “boards” element is used)

availabilityRQ/accommodations

Array of accommodations

 

Array of accommodations

availabilityRQ/accommodations/accommodation

String

 

Hotelbeds accommodation internal code/name (mandatory if the accommodations element is used)

availabilityRQ/reviews/review/@minRate Int Minimun review rating you want the results to have.
availabilityRQ/reviews/review/@maxRate Int Maximum review rating you want the results to have.
availabilityRQ/reviews/review/@minReviewCount Int Minumum number of counts you want the reviews in the response to have.
availabilityRQ/reviews/review/@type String value:
"TRIPADVISOR", "HOTELBEDS" 

availabilityRQ/filter

Element

 

Filter element

availabilityRQ/filter/@minRate

float

Optional

It filters rates which ‘net’ value is lower than minRate

availabilityRQ/filter/@maxRate

float

Optional

It filters rates which ‘net’ value is higher than maxRate

availabilityRQ/filter/@maxRatesPerRoom

Int

Optional

Maximum number of rates per room

availabilityRQ/filter/@maxRooms Int Optional Maximum number of rooms you want to receive for each hotel

availabilityRQ/filter/@packaging

Boolean

Optional

The attribute is used to include or exclude package rates. Values are:

TRUE = Package rates are included 

FALSE = Package rates are excluded (default value)

availabilityRQ/filter/@hotelPackage String Optional

It is used to include or exclude hotel packages. Those are packages created by us that include another product (like massage, a ticket, etc.) together with the hotel.

Values:

YES : To retrieve only hotel packages

NO: To retrieve only non hotel packages.

BOTH: To receive both hotel packages and not (option by default) 

availabilityRQ/filter/@minCategory

Int

Optional

Minimun category to be returned

availabilityRQ/filter/@maxCategory

Int

Optional

Maximum category to be returned

availabilityRQ/filter/@paymentType

String

Optional

Values:

AT_WEB: Merchant model

AT_HOTEL: Pay at hotel model

BOTH: Both (Default value)

availabilityRQ/filter/@contract String Optional Filters the results by the contract requested (NOTE: when using this filter is mandatory to inform availabilityRQ/@aifUse attribute)

Request XML Example

<?xml version="1.0" encoding="UTF-8"?>
<availabilityRQ xmlns="http://www.hotelbeds.com/schemas/messages" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" dailyRate="true">
   <stay checkIn="2016-06-15" checkOut="2016-06-16" />
   <occupancies>
      <occupancy rooms="1" adults="1" children="1">
		<paxes>
			<pax type="CH" age="4"/>
		</paxes>	  
	  </occupancy>
   </occupancies>
   <hotels>
      <hotel>1067</hotel>
      <hotel>1070</hotel>
   </hotels>
   <keywords>
      <keyword>34</keyword>
      <keyword>38</keyword>
      <keyword>100</keyword>
   </keywords>
   <boards included="true">
      <board>RO</board>
      <board>BB</board>
   </boards>
   <rooms included="true">
      <room>DBT.ST</room>
   </rooms>
   <accommodations>
      <accommodation>HOTEL</accommodation>
      <accommodation>HOSTEL</accommodation>
   </accommodations>
   <reviews>
      <review type="TRIPADVISOR" maxRate="5" minReviewCount="3" />
   </reviews>
   <filter minRate="100.000" maxRate="170.000" />
   <filter minCategory="3" maxCategory="5" />
   <filter paymentType="AT_HOTEL" />
   <filter maxRatesPerRoom="3" />
   <filter packaging="true" />
   <filter hotelPackage="yes" />
   <filter maxRooms="2" />
</availabilityRQ>

 

Request JSON Example

{
   "stay": {
      "checkIn": "2016-08-15",
      "checkOut": "2016-08-20",
      "shiftDays": "2"
   },
   "occupancies": [
      {
         "rooms": 1,
         "adults": 1,
         "children": 1,
         "paxes": [
           {
            "type": "CH",
            "age": 2
           }
         ]
      }
   ],
   "hotels": {
      "hotel": [
         1,
         271
      ]
   },
   "rooms": {
      "included": true,
      "room": [
         "DBT.ST"
      ]
   },
   "keywords": {
      "keyword": [
         34,
         38
      ]
   },
   "accommodations": [
      "HOTEL",
      "HOSTEL"
   ],
   "boards": {
      "included": true,
      "board": [
         "RO",
         "BB"
      ]
   },
   "reviews": [
      {
         "type": "TRIPADVISOR",
         "maxRate": 5,
         "minReviewCount": 3
      }
   ],
   "filter": {
      "minRate": 100,
      "maxRate": 1700,
      "minCategory": 3,
      "maxCategory": 5,
      "paymentType": "AT_HOTEL",
      "maxRatesPerRoom": 3,
      "packaging": true,
      "hotelPackage": "YES",
      "maxRooms": 2
   },
   "dailyRate": true
}

Availability Response

The hotel availability response contains all information necessary to confirm the booking or to recheck availability for a particular hotel.

It is distributed in hotel nodes which contain the information about the hotel and the different rates with their room types and board types.

Promotions & offers

Some rates have a promotion or offer applied and included in the availability response, which can be marked as a special offer.

Non-refundable rates (NRF)

Pay special attention to non-refundable rates, marked with the rateClass attribute value NRF. Non-refundable prices already include supplements and discounts.

Reducing the weight of XML or JSON feed

In order to reduce the weight of the XML or JSON response, the availability response is customizable and several nodes, in addition to the node descriptions can be removed. We have three response options: full, medium and saver.

Ask our support agents about the best way to reduce the XML or JSON feed.

 

Response parameters

Node/Atribute

Type

Description

availabilityRS

Element

Top Element

availabilityRS/auditData

Element

Relevant internal information

availabilityRS/auditData/@processTime

Float

Server process time in milliseconds

availabilityRS/auditData/@timestamp

Date

Date/time when the request has been processed (always in Spanish time)

availabilityRS/auditData/@requestHost String IP address of the system host

availabilityRS/auditData/@serverId

String

Server code or ID (for internal use)

availabilityRS/auditData/@environment

String

Environment where the request has been sent and processed

availabilityRS/auditData/@release String Release version identifier
availabilityRS/auditData/@token String Token identifier of the operation
availabilityRS/auditData/@internal String Internal identifier of the parameters of the operation

availabilityRS/hotels

Array of hotel elements

List of available hotels

availabilityRS/hotels/@total

Int

Number of hotels returned

availabilityRS/hotels/@checkIn

Date

Check-in date

Format: YYYY-MM-DD

availabilityRS/hotels/@checkOut

Date

Check-out date

Format: YYYY-MM-DD

availabilityRS/hotels/hotel

Element

Element that contains information about the hotel and associated rates

availabilityRS/hotels/hotel/keywords

Array of keyword elements

 List of keyword elements

availabilityRS/hotels/hotel/keywords/keyword

Element

Element that contains information about the keyword

availabilityRS/hotels/hotel/keywords/keyword/@code

Int

Keyword code

availabilityRS/hotels/hotel/keywords/keyword/@rating

Int

Keyword rating

availabilityRS/hotels/hotel/@name

String

Hotel name

availabilityRS/hotels/hotel/@code

Int

Hotelbeds internal hotel code

availabilityRS/hotels/hotel/@address

String

Hotel address

availabilityRS/hotels/hotel/@categoryCode

String

Hotel category code

availabilityRS/hotels/hotel/@categoryName

String

Category name

availabilityRS/hotels/hotel/@destinationCode

String

Destination code for hotel location

availabilityRS/hotels/hotel/@destinationName

String

Destination name for hotel location

availabilityRS/hotels/hotel/@zoneName

String

Zone name for hotel location

availabilityRS/hotels/hotel/@zoneCode

Int

Zone code for hotel location

availabilityRS/hotels/hotel/@latitude

Float

Latitude data for geolocation

availabilityRS/hotels/hotel/@longitude

Float

Longitude data for geolocation

availabilityRS/hotels/hotel/@currency

String

Client currency 

availabilityRS/hotels/hotel/@maxRate

Float

Maximum hotel room price

availabilityRS/hotels/hotel/@minRate

Float

Minimum hotel room price 

availabilityRS/hotels/hotel/@giata

Int

Giata hotel code

availabilityRS/hotels/hotels/creditCards

Array of credit cards

List of credit cards accepted by the hotel in case of Liberate (pay at hotel) model

availabilityRS/hotels/hotels/creditCards/creditCard

Element

Element that contains information about the credit card

availabilityRS/hotels/hotels/creditCards/creditCard/@code

Int

Credit card code

availabilityRS/hotels/hotels/creditDards/creditCard/@name

String

Credit card name

availabilityRS/hotels/hotels/creditDards/creditCard/@paymentType

String

Type of payment

AT_HOTEL

AT_WEB

availabilityRS/hotels/hotel/rooms

Array of room elements

List of rooms available for a particular hotel

availabilityRS/hotels/hotel/rooms/room/

Element

Element that contains information about the room and associated rates

availabilityRS/hotels/hotel/rooms/room/@code

String

Internal room code (do not confuse with roomId)

availabilityRS/hotels/hotel/rooms/room/@name String Name of the room

availabilityRS/hotels/hotel/rooms/room/rates

Array of rates

List of rates

availabilityRS/hotels/hotel/rooms/room/rates/rate

Element 

Rate element

availabilityRS/hotels/hotel/rooms/room/rates/rate/@rateCommentsId

Int

Comments associated to this rate (more information here)

availabilityRS/hotels/hotel/rooms/room/rates/rate/@rateKey

String

Internal rate key to be used for confirmation

availabilityRS/hotels/hotel/rooms/room/rates/rate/@rateClass

String

Values:

NOR = Normal

NRF = Non-refundable

SPE = Special 

OFE = Offer

PAQ = Package  

NRP = Non-refundable package

availabilityRS/hotels/hotel/rooms/room/rates/rate/@rateType

String

Whether the booking can be confirmed in two steps (BOOKABLE) or three steps (RECHECK)

availabilityRS/hotels/hotel/rooms/room/rates/rate/@paymentType

String

Identifies if it is pay at hotel or merchant model

availabilityRS/hotels/hotel/rooms/room/rates/rate/@packaging

String

Identifies if the rate is for packaging

availabilityRS/hotels/hotel/rooms/room/rates/rate/@boardCode

String

Internal board code

availabilityRS/hotels/hotel/rooms/room/rates/rate/@boardName

 

Board name

availabilityRS/hotels/hotel/rooms/room/rates/rate/@net

Float

Room net price

availabilityRS/hotels/hotel/rooms/room/rates/rate/@discount Float Agency commission
availabilityRS/hotels/hotel/rooms/room/rates/rate/@discountPCT Float Agency commission percentage

availabilityRS/hotels/hotel/rooms/room/rates/rate/@sellingRate

Float

Room gross price in case it is included

availabilityRS/hotels/hotel/rooms/room/rates/rate/@comission

Float

Commission for commissionable model

availabilityRS/hotels/hotel/rooms/room/rates/rate/@comissionVAT

Float

VAT commission

availabilityRS/hotels/hotel/rooms/room/rates/rate/@comissionPCT

Float

Percentage of the commission

availabilityRS/hotels/hotel/rooms/room/rates/rate/@hotelSellingRate

Float

Room gross price in hotelCurrency (for the pay at hotel model)

availabilityRS/hotels/hotel/rooms/room/rates/rate/@hotelCurrency

String

Hotel currency (for the pay at hotel model)

availabilityRS/hotels/hotel/rooms/room/rates/rate/@hotelMandatory

Boolean

Identifies if the rate price is recommended

availabilityRS/hotels/hotel/rooms/room/rates/rate/@allotment

Int

Number of rooms available for a particular room type

availabilityRS/hotels/hotel/rooms/room/rates/rate/@rooms

Int

Number of rooms requested with the same occupancy

availabilityRS/hotels/hotel/rooms/room/rates/rate/@adults

Int

Number of adults for the room

availabilityRS/hotels/hotel/rooms/room/rates/rate/@children

Int

Number of children requested

availabilityRS/hotels/hotel/rooms/room/rates/rate/@childrenAges

String

Children ages separated by commas

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts

Array of shift elements

List of rates for the flexible dates with availability

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate

Element

Element that contains information about flexible dates with availability and rates

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@checkIn

Date

Check-in date

Format: YYYY-MM-DD

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@checkOut

Date

Check-out date

Format: YYYY-MM-DD

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@rateKey

String

Internal rate key to be used for confirmation

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@rateClass

String

Values:
NOR = Normal
NRF = non-refundable
SPE = Special 
OFE = Offer
PAQ = Package 

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@rateType

String

If its value is BOOKABLE you can book straight away. If it is RECHECK you must double check first using ‘CheckRate’ method.

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate//@paymentType

String

Identifies if it is pay at hotel or merchant model

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate//@packaging

String

Identifies if the rate is for packaging

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate//@boardCode

String

Internal board code

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@net

Float

Room net price

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@sellingRate

Float

Room selling price in case it is included

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@comission

Float

Commission in case of commissionable model

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@hotelSellingPrice

Float

Room gross price in hotelCurrency (for the pay at hotel model)

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@hotelCurrency

String

Hotel currency (for the pay at hotel model)

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@hotelMandatory

Boolean

Identifies if the rate price is recommended

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@allotment

Int

Number of rooms available for a particular room type

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@rooms

Int

Number of rooms requested of the type

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@adults

Int

Number of adults for the room

availabilityRS/hotels/hotel/rooms/room/rates/rate/shifts/shiftRate/@children

Int

Number of children requested

availabilityRS/hotels/hotel/rooms/room/rates/rate/cancellationPolicies

Array of policies elements

List of cancellation policies

availabilityRS/hotels/hotel/rooms/room/rates/rate/cancellationPolicies/cancellationPolicy

Element

 

availabilityRS/hotels/hotel/rooms/room/rates/rate/cancellationPolicies/cancellationPolicy/@amount

Float

Amount that will be charged after a certain date

availabilityRS/hotels/hotel/rooms/room/rates/rate/cancellationPolicies/cancellationPolicy/@from

Date

Beginning date when the amount will be charged

availabilityRS/hotels/hotel/rooms/room/rates/rate/cancellationPolicies/cancellationPolicy/@hotelAmount

Float

Amount that will be charged after a certain date in hotel currency (for the pay at hotel model)

 

 

 

availabilityRS/hotels/hotel/rooms/room/rates/rate/dailyPrices/dailyPrice/@offset

Int

Day number of the searched period

availabilityRS/hotels/hotel/rooms/room/rates/rate/dailyPrices/dailyPrice/@dailySellingRate

Float

Daily selling price for the room

availabilityRS/hotels/hotel/rooms/room/rates/rate/dailyPrices/dailyPrice/@dailyNet

Float

Daily net price

availabilityRS/hotels/hotel/rooms/room/rates/rate/offers

Array of offer elements

List of offers

availabilityRS/hotels/hotel/rooms/room/rates/rate/offers/offer

Element

Element that contains offer information

availabilityRS/hotels/hotel/rooms/room/rates/rate/offers/offer/@code

Int

Offer code

availabilityRS/hotels/hotel/rooms/room/rates/rate/offers/offer/@amount

Float

Offer amount

availabilityRS/hotels/hotel/rooms/room/rates/rate/offers/offer/@name

String

Offer name

availabilityRS/hotels/hotel/rooms/room/rates/rate/promotions

Array of promotion elements

List of promotions for a particular rate

availabilityRS/hotels/hotel/rooms/room/rates/rate/promotions/promotion

Element

Element that contains promotion information

availabilityRS/hotels/hotel/rooms/room/rates/rate/promotions/promotion/@code

Int

Promotion code

availabilityRS/hotels/hotel/rooms/room/rates/rate/promotions/promotion/@name

String

Promotion name

availabilityRS/hotels/hotel/rooms/room/rates/rate/promotions/promotion/@remark

String

Promotion remark

availabilityRS/hotels/hotel/rooms/room/rates/rate/taxes

Array of tax elements

List of prices with taxes included or excluded

Response XML Example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<availabilityRS xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.hotelbeds.com/schemas/messages" schemaLocation="http://www.hotelbeds.com/schemas/messages">
    <auditData processTime="144" timestamp="2015-09-08 10:01:35.568" requestHost="212.170.239.110" serverId="ws3xmi01" environment="[itest, iSET_A, ehcache]" release="4726" token="77f43144-9d41-4bf2-bc32-c51468d1283f" internal="|01||14|90||||34,38,100|||||1"/>
    <hotels checkIn="2015-09-19" checkOut="2015-09-21" total="14">
        <hotel code="6914" name="BelleVue Vistanova" categoryCode="3EST" categoryName="3 STARS" destinationCode="PMI" destinationName="Majorca" zoneCode="29" zoneName="Palmanova" latitude="39.511228" longitude="2.540229" currency="EUR" minRate="104.180" maxRate="110.700">
            <rooms>
                <room code="DUS.ST" name="DOUBLE SINGLE USE">
                    <rates>
                        <rate paymentType="AT_WEB" packaging="false" boardCode="BB" boardName="BED AND BREAKFAST" rooms="1" adults="1" children="0" rateKey="6914|DUS.ST|CG-TODOS1|1|BB||1~1~0||20150919|20150921|W|N#1747115603" rateClass="NOR" rateType="BOOKABLE" net="104.180" allotment="20"/>
                        <rate paymentType="AT_WEB" packaging="false" boardCode="HB" boardName="HALF BOARD" rooms="1" adults="1" children="0" rateKey="6914|DUS.ST|CG-TODOS1|1|HB||1~1~0||20150919|20150921|W|N#1747115603" rateClass="NOR" rateType="BOOKABLE" net="110.700" allotment="20"/>
                    </rates>
                </room>
            </rooms>
        </hotel>
     </hotels>
</availabilityRS>

 

Response JSON Example

 

{
   "auditData": {
      "processTime": "94",
      "timestamp": "2015-09-14 09:45:48.316",
      "requestHost": "212.170.239.110",
      "serverId": "ws3xmi01",   
      "environment": "[itest, iSET_A, ehcache]",
      "release": "4838",
      "token": "a7bbe92b-f9d7-480d-a65c-43070ef81b15",
      "internal": "|02||2|5|null,null||||||||1"
   },
   "hotels": {
      "hotels": [
         {
            "code": 2643,
            "name": "Club Marthas",
            "categoryCode": "4EST",
            "categoryName": "4 STARS",
            "destinationCode": "PMI",
            "destinationName": "Majorca",
            "zoneCode": 90,
            "zoneName": "Cala d'Or",
            "latitude": "39.364207",
            "longitude": "3.226974",
            "rooms": [
               {
                  "code": "STU.C2",
                  "name": "STUDIO",
                  "rates": [
                     {
                        "rateKey": "2643|STU.C2|REP-OPACO|1|FB||1~1~1|8|20160608|20160610|W|N#236920111",
                        "rateClass": "NOR",
                        "rateType": "BOOKABLE",
                        "net": "158.020",
                        "allotment": 90,
                        "paymentType": "AT_WEB",
                        "packaging": false,
                        "boardCode": "FB",
                        "boardName": "FULL BOARD",
                        "cancellationPolicies": [
                           {
                              "amount": "79.010",
                              "from": "2016-06-08T00:00:00+02:00"
                           }
                        ],
                        "rooms": 1,
                        "adults": 1,
                        "children": 1,
                        "childrenAges": "8",
                        "offers": [
                           {
                              "code": "9002",
                              "name": "Early Booking discount",
                              "amount": "-52.700"
                           }
                        ]
                     }
                  ],
                  "minRate": "86.320",
                  "maxRate": "119.060",
                  "currency": "EUR"
               }
            ],
            "checkIn": "2016-06-08",
            "checkOut": "2016-06-10",
            "total": 2
         }
      ]
   }
}

Docs Navigation