Documentation

Here are some tips to make it easier to understand and read facilities from content-api.

It is very important to read the facilities as they contain relevant information about the room that the client will appreciate having before booking.

For each facility you get from the Content API/types/facilities will contain a facilityCode, a facilityGroupCode and a facilitytypology.

The description of each of these values can be consulted in the description of the Content API/types/facilities, Content API/types/facilitygroups and Content API/types/facilitytypologies operations.

For some of the facilities available, you might find there’s an extra tag “number”. The value provided indicates the numeric value of the facility itself.

FACILITIES:

You can get the information relative to the facilities on the Content API/types/facilities operation:

https://api.hotelbeds.com/hotel-content-api/1.0/types/facilities?fields=all&language=ENG&from=1&to=1000&useSecondaryLanguage=false

In the response you’ll find the code as shown below. Examples:

FACILITYGROUPS

You can get the information relative to the facilitiygroups on the Content API/types/facilitygroups operation:

https://api.hotelbeds.com/hotel-content-api/1.0/types/facilitygroups?fields=all&language=ENG&from=1&to=1000&useSecondaryLanguage=false

In the response you’ll find the code as shown below

Examples:

FACILITYTYPOLOGIES

Each facility contains a facilityTypologyCode. This typologycode describes the logic for the flags within a facility (numberflag, logicflag, feeflag, indYesOrNoFlag, amountflag…) which will apply or not for that specific facility.

You can get the information relative to the facilityTypologyCodes on the Content API/types/facilitytypologies operation:

https://api.hotelbeds.com/hotel-content-api/1.0/types/facilitytypologies?fields=all&language=ENG&from=1&to=1000&useSecondaryLanguage=false

Definition of the main logic flags within the facilities

The definition of each of the flags used in the facilities is described in our developer portal:

https://developer.hotelbeds.com/documentation/hotels/content-api/api-reference/#operation/hotelWithIdDetailsUsingGET

Find below a detailed explanation for the main ones:

• indYesOrNo and indlogic: Indicates if the facility exists (if it’s present) at the hotel/room:
  • If “True” = exists
  • If “False” = doesn’t exist
    • Only one of these two flags will appear in a facility. The difference between both is:
• “indYesOrNo” means that it’s a mandatory facility to inform
• “indLogic” means the facility is not mandatory to inform.
  • • indFee: Indicates whether the fee is paid / free to use
  • If “True” = has to be paid
    • In case HBG has the info on how much is the cost for this facility to be paid, it’ll be shown as the value of amount tag
  • If “False” = it’s free

Examples:

indLogic=”false”

This room facility indicates that there is no Balcony in that room.

• FacilityCode = “230” means “Balcony”
• FacilityGroupCode = “60” means “Room facilities (Standard room)”
• IndLogic = “false” means it’s not present

indLogic="true" + indFee="false"

This room facility indicates that there is Internet Access in that room and it’s free

• FacilityCode = “100” means “Internet access”
• FacilityGroupCode = “60” means “Room facilities (Standard room)”
• IndLogic = “true” means it’s present
• indFee = “false” means it has no cost
  
  

indYesOrNo="true" + indFee="true"

This hotel facility indicates that Car park is available at the hotel and it has a cost of 360 SEK if the guest wants to use it.

• FacilityCode = “320” means “Car Park”
• FacilityGroupCode = “70” means “Facilities”
• IndYesOrNo = “true” means it’s present
• indFee = “true” means it has cost
• amount = “360” and currency = “SEK” means the cost is 360 SEK
  

number is present – Room size

This hotel facility indicates that the Room Size for the room is 16 sqm

• FacilityCode = “295” means “Room size (sqm)”
• FacilityGroupCode = “60” means “Room facilities (Standard room)”
• Number = “16” indicates the value for this facility is “16”
• IndYesOrNo = “true” means it’s present
  

number is present – Year of construction

This hotel facility indicates that the hotel Year of construction is 1990

• FacilityCode = “20” means “Year of construction”
• FacilityGroupCode = “10” means “Location”
• Number = “1990” indicates the value for this facility is “1990”
  

Facilities as you get it from hoteldetails and hotels

While the above explanation and examples show you how to read the facilities, there’s a minor difference on how you’ll find the facilities when running HotelsRQ

https://api.hotelbeds.com/hotel-api/1.0/hotels?fields=all&language=ENG&destinationCode=DXB&from=1&to=1000&useSecondaryLanguage=false&codes=

or HotelDetailsRQ

https://api.hotelbeds.com/hotel-api/1.0/hotels/64239?language=ENG

When reading the facilities on these two operations, you won’t get the facilitytypology value, instead the system will automatically bring the info associated with the facilitytypology.

Instead of getting “facilityTypologyCode="26", you’ll get indLogic="true" indFee="false"

Example