ETG API V3
Affiliate API
Static content
Retrieve hotel content

Retrieve hotel content

#affiliate

https://api.worldota.net/api/b2b/v3/hotel/info/

The call searches for static hotel data by the hotel ID. Use the call in cases:

  • An available hotel isn’t included in the hotel data dump. It can happen with new hotels in the ETG inventory.
  • You want to check the content before making a booking with a possible update.
ℹ️

The limitations:

  • The maximum number of requests is 30 per 60 seconds.
⚠️
  • Any internal content such as photos, descriptions, and others can’t be indexed. It isn’t allowed.
  • Any public content such as name, address, amenities, and policies can be indexed.
  • If you try to download all images from CDN without a corresponding search request by the user, your IP address will be blocked.

To avoid blocking, send the custom User-Agent header with the information:

  • Required:
    • PartnerName.
    • ClientVersion.
  • Optional:
    • ClientTechicalDetails.

Request example 

curl --user '<KEY_ID>:<API_KEY>' 'https://api.worldota.net/api/b2b/v3/hotel/info/' \
--header 'Content-Type: application/json' \
--data '{
    "id": "test_hotel_do_not_book",
    "language": "en"
}'

Request body

id String required or optional

The unique hotel ID.

ℹ️
  • Either this field or the hid field is required.
hid Int required or optional

The most preferred hotel ID.

ℹ️
  • Either this field or the id field is required.
  • The maximum length is 7 characters.
language Int required or optional

The language.

ℹ️

The possible values:

  • ar — Arabic.
  • bg — Bulgarian.
  • cs — Czech.
  • da — Danish.
  • de — German.
  • el — Greek.
  • en — English.
  • es — Spanish.
  • fi — Finnish.
  • fr — French.
  • he — Hebrew.
  • hu — Hungarian.
  • it — Italian.
  • ja — Japanese.
  • kk — Kazakh.
  • ko — Korean.
  • nl — Dutch.
  • no — Norwegian.
  • pl — Polish.
  • pt — Portuguese.
  • pt_PT — Portuguese (Portugal).
  • ro — Romanian.
  • ru — Russian.
  • sq — Albanian.
  • sr — Serbian.
  • sv — Swedish.
  • th — Thai.
  • tr — Turkish.
  • uk — Ukrainian.
  • vi — Vietnamese.
  • zh_CN — Simplified Chinese.
  • zh_TW — Traditional Chinese.

Response

address String
The hotel physical address.
amenity_groups [Object]

The hotel amenities list divided in groups. For example, Health and Safety Measures, Beauty and wellness.

amenities [String]
The list of amenities inside the group.
group_name String
The amenity group name.
non_free_amenities [String]
The list of additional non-free services.
check_in_time String
The check-in time. The local time in the HH:MM:SS format.
check_out_time String
The check-out time. The local time in the HH:MM:SS format.
description_struct Object

The list of hotel descriptions divided into paragraphs.

paragraphs [String]
The description itself.
title String
The description title.
email String
The hotel email address.
hotel_chain String
The hotel chain name.
id [String]

The unique hotel ID.

ℹ️
  • Either this field or the hid field is required.
hid [String]

The most preferred hotel ID.

ℹ️
  • Either this field or the id field is required.
  • The maximum length is 7 characters.
images [String]

The list of the URLs for the hotel images.

Each URL has the {size} placeholder. Meaning, the size of the image you can get.

ℹ️
  • The possible size meanings:
    • crop — the image is fit by the width and is cut equally from the bottom and top till the middle part of the height.
    • fit-h — the image is fit into the rectangle by the height.
    • fit — the image is fit into the rectangle by the size in question.
  • The possible values:
    • 100x100 — crop.
    • 1024x768 — fit.
    • 120x120 — crop.
    • 240x240 — crop.
    • x220 — fit-h.
    • x500 — fit-h.
images_ext [Object]

Information about the hotel images divided into categories.

category_slug String

The hotel image category.

ℹ️
  • The possible values:
    • unspecified — unspecified.
    • balcony — balconies.
    • bathroom — bathrooms.
    • beach — beaches.
    • business — business zone.
    • entertainment — entertainment zones.
    • exterior — hotel exterior.
    • guest_rooms — guest rooms.
    • hotel_front — hotel front.
    • hotel_rooms — hotel rooms.
    • lobby — lobby.
    • meal — meals.
    • outside — hotel outside view.
    • pool — pools.
    • spa — SPA zones.
    • sports — sport zones.
    • children — children zones.
    • miscellaneous — other.
url String

The URL for the hotel image.

Each URL has the {size} placeholder. Meaning, the size of the image you can get.

ℹ️
  • The possible size meanings:
    • crop — the image is fit by the width and is cut equally from the bottom and top till the middle part of the height.
    • fit-h — the image is fit into the rectangle by the height.
    • fit — the image is fit into the rectangle by the size in question.
  • The possible values:
    • 100x100 — crop.
    • 1024x768 — fit.
    • 120x120 — crop.
    • 240x240 — crop.
    • x220 — fit-h.
    • x500 — fit-h.
kind String

The hotel type.

ℹ️

The possible values:

  • Resort.
  • Sanatorium.
  • Guesthouse.
  • Mini-hotel.
  • Castle.
  • Hotel.
  • Boutique_and_Design.
  • Apartment.
  • Cottages_and_Houses.
  • Farm.
  • Villas_and_Bungalows.
  • Camping.
  • Hostel.
  • BNB.
  • Glamping.
  • Apart-hotel.
latitude Float
The hotel geographical latitude.
longitude Float
The hotel geographical longitude.
name String
The hotel name.
metapolicy_struct Object

The additional accommodation conditions. Is the same as the section “Hotel policies” from hotel pages on the core website.

In the field, you can find taxes and fees not included in the booking price.

add_fee [Object] required

The additional services, fees, and taxes information.

currency String required
The additional services, fees, and taxes price currency. Is the same as the hotel currency.
fee_type String required

The additional service type.

ℹ️

The possible values:

  • unspecified.
  • television.
  • towels.
  • conditioning.
  • housekeeping.
  • heating.
  • refrigerator.
  • utility.
  • safe.
  • microwave.
  • luggage_storage.
  • tour_guide.
  • bicycle_rental.
  • baby_highchair.
  • bed_linen.
  • towels_only.
  • luggage_storage_apartment.
  • luggage_storage_office.
price String required
The additional services, fees, and taxes price in the hotel currency.
price_unit String required

The additional service price unit.

ℹ️

The possible values:

  • unspecified.
  • per_guest_per_night.
  • per_guest_per_stay.
  • per_room_per_night.
  • per_room_per_stay.
  • per_hour.
  • per_week.
check_in_check_out [Object] required

The check-in and check-out policies’ information.

check_in_check_out_type String required

The check-in or check-out type.

ℹ️

The possible values:

  • unspecified.
  • early_checkin.
  • late_checkout.
  • holiday_checkin.
  • holiday_checkout.
currency String required
The check-in and check-out price currency. Is the same as the hotel currency.
inclusion String required

The check-in and check-out inclusion.

ℹ️

The possible values:

  • unspecified.
  • included.
  • not_included.
price String required
The check-in or check-out price in the hotel currency.
children [Object] required

The children extra bed policy information.

age_start Int required
The minimum child age for the children extra bed policy being applied.
age_end Int required
The maximum child age for the children extra bed policy being applied.
currency String required
The child extra bed price currency. Is the same as the hotel currency.
extra_bed String required

The extra bed for a child availability.

ℹ️

The possible values:

  • unspecified.
  • available.
  • unavailable.
price String required
The child extra bed price in the hotel currency.
children_meal [Object] required

The children meal policy information.

age_start Int required
The minimum child age for the children meal policy being applied.
age_end Int required
The maximum child age for the children meal policy being applied.
currency String required
The children meal price currency. Is the same as the hotel currency.
inclusion String required

The children meal inclusion.

ℹ️

The possible values:

  • unspecified.
  • included.
  • not_included.
meal_type String required

The children meal type.

ℹ️

The possible values:

  • unspecified.
  • all-inclusive.
  • breakfast.
  • breakfast-buffet.
  • continental-breakfast.
  • dinner.
  • full-board.
  • half-board.
  • lunch.
  • nomeal.
  • some-meal.
  • english-breakfast.
  • american-breakfast.
  • asian-breakfast.
  • chinese-breakfast.
  • israeli-breakfast.
  • japanese-breakfast.
  • scandinavian-breakfast.
  • scottish-breakfast.
  • breakfast-for-1.
  • breakfast-for-2.
  • super-all-inclusive.
  • soft-all-inclusive.
  • ultra-all-inclusive.
  • half-board-lunch.
  • half-board-dinner.
price String required
The children meal price in the hotel currency.
cot [Object] required

The cots’ policy information.

amount Int required
The available cot number.
currency String required
The cot price currency. Is the same as the hotel currency.
inclusion String required

The cot inclusion.

ℹ️

The possible values:

  • unspecified.
  • included.
  • not_included.
price String required
The cot price in the hotel currency.
price_unit String required

The cot price unit.

ℹ️

The possible values:

  • unspecified.
  • per_guest_per_night.
  • per_guest_per_stay.
  • per_room_per_night.
  • per_room_per_stay.
  • per_hour.
  • per_week.
deposit [Object] required

The deposit information.

availability String required

The deposit availability.

ℹ️

The possible values:

  • unspecified.
  • available.
  • unavailable.
currency String required
The deposit amount currency. Is the same as the hotel currency.
deposit_type String required

The deposit type.

ℹ️

The possible values:

  • unspecified.
  • pet.
  • breakage.
  • keys.
payment_type String required

The deposit payment type.

ℹ️

The possible values:

  • unspecified.
  • cash.
  • card.
price String required
The deposit amount in the hotel currency.
price_unit String required

The deposit amount unit.

ℹ️

The possible values:

  • unspecified.
  • per_guest_per_night.
  • per_guest_per_stay.
  • per_room_per_night.
  • per_room_per_stay.
  • per_hour.
  • per_week.
pricing_method String required

The deposit pricing method.

ℹ️

The possible values:

  • unspecified.
  • percent.
  • fixed.
extra_bed [Object] required

The extra beds’ policy information.

amount Int required
The available extra bed number.
currency String required
The extra bed price currency. Is the same as the hotel currency.
inclusion String required

The extra bed inclusion.

ℹ️

The possible values:

  • unspecified.
  • included.
  • not_included.
price String required
The extra bed price in the hotel currency.
price_unit String required

The extra bed price unit.

ℹ️

The possible values:

  • unspecified.
  • per_guest_per_night.
  • per_guest_per_stay.
  • per_room_per_night.
  • per_room_per_stay.
  • per_hour.
  • per_week.
internet [Object] required

The internet policy information.

currency String required
The internet price currency. Is the same as the hotel currency.
inclusion String required

The internet inclusion.

ℹ️

The possible values:

  • unspecified.
  • included.
  • not_included.
internet_type String required

The internet type.

ℹ️

The possible values:

  • unspecified.
  • wireless.
  • wired.
price String required
The internet price in the hotel currency.
price_unit String required

The internet price unit.

ℹ️

The possible values:

  • unspecified.
  • per_guest_per_night.
  • per_guest_per_stay.
  • per_room_per_night.
  • per_room_per_stay.
  • per_hour.
  • per_week.
work_area String required

The internet coverage area.

ℹ️

The possible values:

  • unspecified.
  • hotel.
  • room.
meal [Object] required

The meal policy information.

currency String required
The meal price currency. Is the same as the hotel currency.
inclusion String required

The meal inclusion.

ℹ️

The possible values:

  • unspecified.
  • included.
  • not_included.
meal_type String required

The meal type.

ℹ️

The possible values:

  • unspecified.
  • all-inclusive.
  • breakfast.
  • breakfast-buffet.
  • continental-breakfast.
  • dinner.
  • full-board.
  • half-board.
  • lunch.
  • nomeal.
  • some-meal.
  • english-breakfast.
  • american-breakfast.
  • asian-breakfast.
  • chinese-breakfast.
  • israeli-breakfast.
  • japanese-breakfast.
  • scandinavian-breakfast.
  • scottish-breakfast.
  • breakfast-for-1.
  • breakfast-for-2.
  • super-all-inclusive.
  • soft-all-inclusive.
  • ultra-all-inclusive.
  • half-board-lunch.
  • half-board-dinner.
price String required
The meal price in the hotel currency.
no_show [Object] required

The no-shows policy information.

availability String required

The no-show availability.

ℹ️

The possible values:

  • unspecified.
  • available.
  • unavailable.
day_period String required

The applicable period for no-show.

ℹ️

The possible values:

  • unspecified.
  • before_midday.
  • after_midday.
time String required
The applicable time for no-show. The local time in the HH:MM:SS format.
parking Object required

The parking policy information.

currency String required
The parking price currency. Is the same as the hotel currency.
inclusion String required

The parking inclusion.

ℹ️

The possible values:

  • unspecified.
  • included.
  • not_included.
price String required
The parking price in the hotel currency.
price_unit String required

The parking price unit.

ℹ️

The possible values:

  • unspecified.
  • per_car_per_night.
  • per_car_per_stay.
  • per_guest_per_night.
  • per_guest_per_stay.
  • per_room_per_night.
  • per_room_per_stay.
  • per_hour.
  • per_week.
territory_type String required

The parking territory type.

ℹ️

The possible values:

  • unspecified.
  • on_side.
  • off_side.
pets [Object] required

The pets’ accommodation policy information.

currency String required
The pet accommodation price currency. Is the same as the hotel currency.
inclusion String required

The pet accommodation inclusion.

ℹ️

The possible values:

  • unspecified.
  • included.
  • not_included.
pets_type String required

The pet weight type.

ℹ️

The possible values:

  • unspecified — no information on the pet weight.
  • lt_5kg — the pet weight is less than 5 kg.
  • gt_5kg — the pet weight is greater than 5 kg.
price String required
The pet accommodation price in the hotel currency.
price_unit String required

The pet accommodation price unit.

ℹ️

The possible values:

  • unspecified.
  • per_guest_per_night.
  • per_guest_per_stay.
  • per_room_per_night.
  • per_room_per_stay.
  • per_hour.
  • per_week.
shuttle [Object] required

The shuttles’ policy information.

currency String required
The shuttle price currency. Is the same as the hotel currency.
destination_type String required

The shuttle destination type.

ℹ️

The possible values:

  • unspecified.
  • airport.
  • train.
  • ship.
  • airport_train.
inclusion String required

The shuttle inclusion.

ℹ️

The possible values:

  • unspecified.
  • included.
  • not_included.
shuttle_type String required

The shuttle type.

ℹ️

The possible values:

  • unspecified.
  • one_way.
  • two_ways.
price String required
The shuttle price in the hotel currency.
visa [Object] required

The Visa support policy information.

visa_support String required

The Visa support.

ℹ️

The possible values:

  • unspecified — no information on the Visa support.
  • support_enable — the Visa is supported.
metapolicy_extra_info String

The additional hotel information. Is the same as the section “Extra info” from hotel pages on the core website.

In the field, you can find taxes and fees not included in the booking price.

The data from the field must be shown to the end user.

phone String
The hotel phone number.
policy_struct [Object]
deprecated

The additional accommodation conditions. Is the same as the section “Important - Please Note” from hotel pages on the core website.

In the field, you can find taxes and fees not included in the booking price.

The data from the field is obligatory for showing to the end user.

paragraphs [String]
The policy itself.
title String
The policy title.
postal_code String
The hotel postal code.
region Object

The region where the hotel is located.

country_code String
Hotel’s country code (capital Latin letters, according to ISO 3166-1 alpha-2 standard).
iata String
The region airport IATA code.
id String
The unique ID of the region where the hotel is located.
name String
The name of the region where the hotel is located.
type String

The type of the region where the hotel is located.

ℹ️
  • The possible values:
    • Airport.
    • Bus Station.
    • City.
    • Continent.
    • Country.
    • Multi-City (Vicinity).
    • Multi-Railway Station.
    • Multi-Region (within a country).
    • Neighborhood.
    • Point of Interest.
    • Province (State).
    • Railway Station.
    • Street.
    • Subway (Entrace).
room_groups Object

The list of the hotel room groups.

images [String]

The list of the URLs for the room images.

Each URL has the {size} placeholder. Meaning, the size of the image you can get.

ℹ️
  • The possible size meanings:
    • crop — the image is fit by the width and is cut equally from the bottom and top till the middle part of the height.
    • fit-h — the image is fit into the rectangle by the height.
    • fit — the image is fit into the rectangle by the size in question.
  • The possible values:
    • 100x100 — crop.
    • 1024x768 — fit.
    • 120x120 — crop.
    • 240x240 — crop.
    • x220 — fit-h.
    • x500 — fit-h.
images_ext [Object]

Information about the room images divided into categories.

category_slug String

The room image category.

ℹ️
  • The possible values:
    • unspecified — unspecified.
    • balcony — balconies.
    • bathroom — bathrooms.
    • beach — beaches.
    • business — business zone.
    • entertainment — entertainment zones.
    • exterior — hotel exterior.
    • guest_rooms — guest rooms.
    • hotel_front — hotel front.
    • hotel_rooms — hotel rooms.
    • lobby — lobby.
    • meal — meals.
    • outside — hotel outside view.
    • pool — pools.
    • spa — SPA zones.
    • sports — sport zones.
    • children — children zones.
    • miscellaneous — other.
url String

The URL for the room image.

Each URL has the {size} placeholder. Meaning, the size of the image you can get.

ℹ️
  • The possible size meanings:
    • crop — the image is fit by the width and is cut equally from the bottom and top till the middle part of the height.
    • fit-h — the image is fit into the rectangle by the height.
    • fit — the image is fit into the rectangle by the size in question.
  • The possible values:
    • 100x100 — crop.
    • 1024x768 — fit.
    • 120x120 — crop.
    • 240x240 — crop.
    • x220 — fit-h.
    • x500 — fit-h.
name String
The full room name.
room_amenities [String]

The room amenity list.

To get all available room amenities and their definitions, use the room_amenities field from the Retrieve hotel static data call.

room_group_id Int
deprecated
The room ID.
rg_ext Object

The room ID.

class Int

The room class information.

ℹ️

The possible values:

  • 0 — run of house.
  • 1 — dorm.
  • 2 — capsule.
  • 3 — room.
  • 4 — junior suite.
  • 5 — suite.
  • 6 — apartment.
  • 7 — studio.
  • 8 — villa.
  • 9 — cottage.
  • 17 — bungalow.
  • 18 — chalet.
  • 19 — camping.
  • 20 — tent.
quality Int

The room quality information.

ℹ️

The possible values:

  • 0 — undefined.
  • 1 — economy.
  • 2 — standard.
  • 3 — comfort.
  • 4 — business.
  • 5 — superior.
  • 6 — deluxe.
  • 7 — premier.
  • 8 — executive.
  • 9 — presidential.
  • 17 — premium.
  • 18 — classic.
  • 19 — ambassador.
  • 20 — grand.
  • 21 — luxury.
  • 22 — platinum.
  • 23 — prestige.
  • 24 — privilege.
  • 25 — royal.
sex Int

The room gender restrictions.

ℹ️

The possible values:

  • 0 — undefined.
  • 1 — male.
  • 2 — female.
  • 3 — mixed.
bathroom Int

The room bathroom information.

ℹ️

The possible values:

  • 0 — undefined.
  • 1 — a shared bathroom.
  • 2 — a private bathroom
  • 3 — an external private bathroom.
bedding Int

The room bedding information.

ℹ️

The possible values:

  • 0 — undefined.
  • 1 — a bunk bed.
  • 2 — a single bed.
  • 3 — a double bed.
  • 4 — a twin bed.
  • 7 — multiple beds.
family Int

Whether it is a family room or not.

ℹ️

The possible values:

  • 0 — not a family room.
  • 1 — a family room.
capacity Int

The maximum number of main bed places without additional charges and excluding extra beds, cots, etc.

ℹ️

The possible values:

  • 0 — undefined.
  • 1 — single.
  • 2 — double.
  • 3 — triple.
  • 4 — quadruple.
  • 5 — quintuple.
  • 6 — sextuple.
club Int

Whether it is a club room or not.

ℹ️

The possible values:

  • 0 — not a club room.
  • 1 — a club room.
bedrooms Int

The bedroom number.

ℹ️

The possible values:

  • 0 — undefined.
  • 1 — 1 bedroom.
  • 2 — 2 bedrooms.
  • 3 — 3 bedrooms.
  • 4 — 4 bedrooms.
  • 5 — 5 bedrooms.
  • 6 — 6 bedrooms.
balcony Int

Whether there is a balcony or not.

ℹ️

The possible values:

  • 0 — no balcony.
  • 1 — a balcony.
view Int

The room view information.

ℹ️

The possible values:

  • 0 — undefined.
  • 1 — bay view.
  • 2 — bosphorus view.
  • 3 — burj-khalifa view.
  • 4 — canal view.
  • 5 — city view.
  • 6 — courtyard view.
  • 7 — dubai-marina view.
  • 8 — garden view.
  • 9 — golf view.
  • 17 — harbour view.
  • 18 — inland view.
  • 19 — kremlin view.
  • 20 — lake view.
  • 21 — land view.
  • 22 — mountain view.
  • 23 — ocean view.
  • 24 — panoramic view.
  • 25 — park view.
  • 26 — partial-ocean view.
  • 27 — partial-sea view.
  • 28 — partial view.
  • 29 — pool view.
  • 30 — river view.
  • 31 — sea view.
  • 32 — sheikh-zayed view.
  • 33 — street view.
  • 34 — sunrise view.
  • 35 — sunset view.
  • 36 — water view.
  • 37 — with view.
  • 38 — beachfront.
  • 39 — ocean front.
  • 40 — sea front.
floor Int

The room floor Information.

ℹ️

The possible values:

  • 0 — undefined.
  • 1 — a penthouse floor.
  • 2 — a duplex floor.
  • 3 — a basement floor.
  • 4 — an attic floor.
name_struct Object

The structured room name.

bathroom String

The room bathroom information.

Has the null value, if it is a private bathroom.

bedding_type String
The room bedding information.
main_name String
The room name.
star_rating Int

The hotel rating on a scale from 1 to 5. Has the 0 value for no available rating.

ℹ️
  • The minimum value is 0.
  • The maximum value is 5.
serp_filters [String]

The list of amenities for the hotel selection based on a cumulative set of features from:

  • All the hotels’ rates.
  • And common hotels’ features.

To get all available room amenities and their definitions, use the serp_filters field from the Retrieve hotel static data call.

star_certificate Object

Information about the hotel star certificate.

Applicable only for hotels in some specific countries.

Has the null value if there is no information about the star certificate.

valid_to String
The valid thru date.
certificate_id String

The certificate ID.

Has the null value if there is no information about the certificate ID.

is_closed Boolean
Whether the hotel property is closed or not.
keys_pickup Object

Information about how to pick up the hotel room keys.

type String

The picking-up type.

ℹ️

The possible values:

  • unspecified — no instructions.
  • phone — get the keys with a call. To get the instructions, call the phone number in the phone field of this object.
  • address — get the keys on the address specified in the apartment_office_address field of this object.
  • smartlock — get the keys in a smart lock. Can be opened with an app or code.
  • keypad — get the keys in a lock with a keypad.
  • lockbox — get the keys in a lock box.
  • reception — get the keys at the 24-hour reception.
phone String

The phone number for contacting purposes. The phone number must be valid.

ℹ️
  • The minimum length is 5 characters.
  • The maximum length is 35 characters.
is_contactless Boolean
Whether the hotel room keys’ pick-up is contactless or not.
email String
The email address for contacting purposes. The email address must be valid.
apartment_office_address String
The actual pick-up reception address.
apartment_extra_information String
The additional pick-up information.
facts Object

The hotel information.

floors_number Int
The floors number.
rooms_number Int
The rooms number.
year_built Int
The construction year.
year_renovated Int
The renovation year.
electricity Object

The socket type.

frequency [Int]
The sockets’ frequency.
voltage [Int]
The sockets’ voltage.
sockets [String]

The socket types.

To get all available socket types and their definitions, use the socket_types field from the Retrieve hotel static data call.

payment_methods [String]

The card types accepted at the hotel when pay there.

ℹ️

The possible values:

  • unspecified — unspecified.
  • american_express — American Express.
  • cash — cash.
  • china_unionpay — China UnionPay.
  • diners_club — Diners Club International.
  • euro_mastercard — Euro/Mastercard.
  • jcb — JCB.
  • maestro — Maestro.
  • mastercard — Mastercard.
  • switch_maestro — Switch (Maestro).
  • visa — Visa.
  • visa_debit — Visa Debit.
  • vise_delta — Visa Delta.
  • visa_electron — Visa Electron.
  • pro100 — Pro100.
front_desk_time_start String
The reception opening time. The local time in the HH:MM:SS format.
front_desk_time_end String
The reception closing time. The local time in the HH:MM:SS format.
is_gender_specification_required Boolean
Whether the guests’ gender is required by the hotel or not.

Response example 

{
  "data": {
    "address": "Avenida Roble, Frente al Mall Multiplaza, Tegucigalpa",
    "amenity_groups": [
      {
        "amenities": [
          "24-hour reception",
          "Elevator/lift",
          "Early check-in",
          "Late check-out"
        ],
        "group_name": "General",
        "non_free_amenities": []
      },
      {
        "amenities": [
          "Cable TV",
          "Locker"
        ],
        "group_name": "Rooms",
        "non_free_amenities": []
      },
      {
        "amenities": [
          "Concierge services",
          "Dry-cleaning",
          "Shoe shine"
        ],
        "group_name": "Services and amenities",
        "non_free_amenities": [
          "Dry-cleaning",
          "Shoe shine"
        ]
      },
      {
        "amenities": [
          "Breakfast",
          "Common kitchen",
          "Restaurant",
          "Kitchen"
        ],
        "group_name": "Meals",
        "non_free_amenities": []
      },
      {
        "amenities": [
          "Internet access"
        ],
        "group_name": "Internet",
        "non_free_amenities": []
      },
      {
        "amenities": [
          "Car rental"
        ],
        "group_name": "Transfer",
        "non_free_amenities": [
          "Car rental"
        ]
      },
      {
        "amenities": [
          "Barbeque"
        ],
        "group_name": "Recreation",
        "non_free_amenities": []
      },
      {
        "amenities": [
          "Parking nearby"
        ],
        "group_name": "Parking",
        "non_free_amenities": [
          "Parking nearby"
        ]
      },
      {
        "amenities": [
          "Spa tub"
        ],
        "group_name": "Pool and beach",
        "non_free_amenities": []
      },
      {
        "amenities": [
          "Conference Hall"
        ],
        "group_name": "Business",
        "non_free_amenities": []
      },
      {
        "amenities": [
          "Squash"
        ],
        "group_name": "Sports",
        "non_free_amenities": []
      },
      {
        "amenities": [
          "Pets allowed (free)"
        ],
        "group_name": "Pets",
        "non_free_amenities": []
      }
    ],
    "check_in_time": "14:00:00",
    "check_out_time": "12:00:00",
    "description_struct": [
      {
        "paragraphs": [
          "Your vacation should be comfortable! Hotel «Test Hotel (Do Not Book)» is located in Tegucigalpa. This hotel is located in walking distance from the city center."
        ],
        "title": "Location"
      },
      {
        "paragraphs": [
          "It’s time to have a nice meal! Stop by the restaurant. In the shared kitchen, you can cook anything you want. If you travel by car, there’s a paid parking zone at the hotel. You won’t be bored as at the hotel you will find a barbeque area.",
          "You can take your pet on the journey. Pets are allowed for free. Accessibility: there is an elevator/lift. At the guests’ disposal, there’s also dry cleaning, car rental and a concierge."
        ],
        "title": "At the hotel"
      }
    ],
    "email": "[email protected]",
    "facts": {
      "electricity": {
        "frequency": [
          60
        ],
        "sockets": [
          "a",
          "b"
        ],
        "voltage": []
      },
      "floors_number": null,
      "rooms_number": null,
      "year_built": null,
      "year_renovated": null
    },
    "front_desk_time_end": "00:00:00",
    "front_desk_time_start": "00:00:00",
    "hid": 8473727,
    "hotel_chain": "No chain",
    "id": "test_hotel_do_not_book",
    "images": [
      "https://cdn.worldota.net/t/{size}/extranet/b5/d3/b5d3d33394494c68321246882c1bd93a6832dcd5.jpeg",
      "https://cdn.worldota.net/t/{size}/extranet/15/44/15440558c952ec4c3488730d1563dc9e8d25832c.JPEG",
      "https://cdn.worldota.net/t/{size}/extranet/cf/cd/cfcd60bc8fc0cab8fa26c3c63617d541cf1175ee.jpeg",
      "https://cdn.worldota.net/t/{size}/extranet/6e/5b/6e5b761eaa9e07abfd997ec02d84fa7cf2229fa7.jpeg",
      "https://cdn.worldota.net/t/{size}/extranet/13/11/13115f9ec6d13ae5a3e9b5afdb693e7f22cfcfe0.jpeg",
      "https://cdn.worldota.net/t/{size}/extranet/16/cd/16cd5682059c31242ba09bee5062928cc340b154.JPEG",
      "https://cdn.worldota.net/t/{size}/extranet/11/80/118098dc06238834a9becb33546314a61fc50ff7.jpeg",
      "https://cdn.worldota.net/t/{size}/extranet/55/0f/550f03096f8bf9f458bc8662f2dc4d870ba8f853.jpeg"
    ],
    "images_ext": [
      {
        "category_slug": "hotel_front",
        "url": "https://cdn.worldota.net/t/{size}/extranet/b5/d3/b5d3d33394494c68321246882c1bd93a6832dcd5.jpeg"
      },
      {
        "category_slug": "outside",
        "url": "https://cdn.worldota.net/t/{size}/extranet/15/44/15440558c952ec4c3488730d1563dc9e8d25832c.JPEG"
      },
      {
        "category_slug": "entertainment",
        "url": "https://cdn.worldota.net/t/{size}/extranet/cf/cd/cfcd60bc8fc0cab8fa26c3c63617d541cf1175ee.jpeg"
      },
      {
        "category_slug": "unspecified",
        "url": "https://cdn.worldota.net/t/{size}/extranet/6e/5b/6e5b761eaa9e07abfd997ec02d84fa7cf2229fa7.jpeg"
      },
      {
        "category_slug": "hotel_front",
        "url": "https://cdn.worldota.net/t/{size}/extranet/13/11/13115f9ec6d13ae5a3e9b5afdb693e7f22cfcfe0.jpeg"
      },
      {
        "category_slug": "lobby",
        "url": "https://cdn.worldota.net/t/{size}/extranet/16/cd/16cd5682059c31242ba09bee5062928cc340b154.JPEG"
      },
      {
        "category_slug": "exterior",
        "url": "https://cdn.worldota.net/t/{size}/extranet/11/80/118098dc06238834a9becb33546314a61fc50ff7.jpeg"
      },
      {
        "category_slug": "business",
        "url": "https://cdn.worldota.net/t/{size}/extranet/55/0f/550f03096f8bf9f458bc8662f2dc4d870ba8f853.jpeg"
      }
    ],
    "is_closed": false,
    "is_gender_specification_required": false,
    "keys_pickup": {
      "apartment_extra_information": "",
      "apartment_office_address": "Tegucigalpa, Paseo Juana Lainez, 1",
      "email": "[email protected]",
      "is_contactless": false,
      "phone": "+49243333333",
      "type": "address"
    },
    "kind": "Hotel",
    "latitude": 14.079872,
    "longitude": -87.21677,
    "metapolicy_extra_info": "The given hotel is a fiction and should not be booked. If you book this hotel the further accommodation shall not be provided.",
    "metapolicy_struct": {
      "add_fee": [],
      "check_in_check_out": [],
      "children": [],
      "children_meal": [],
      "cot": [
        {
          "amount": 1,
          "currency": "USD",
          "inclusion": "not_included",
          "price": "0",
          "price_unit": "per_room_per_night"
        }
      ],
      "deposit": [
        {
          "availability": "available",
          "currency": "HNL",
          "deposit_type": "unspecified",
          "payment_type": "cash",
          "price": "123",
          "price_unit": "per_room_per_stay",
          "pricing_method": "fixed"
        },
        {
          "availability": "available",
          "currency": "",
          "deposit_type": "breakage",
          "payment_type": "unspecified",
          "price": "20",
          "price_unit": "per_guest_per_stay",
          "pricing_method": "percent"
        },
        {
          "availability": "available",
          "currency": "BAM",
          "deposit_type": "keys",
          "payment_type": "unspecified",
          "price": "10",
          "price_unit": "per_room_per_stay",
          "pricing_method": "fixed"
        },
        {
          "availability": "available",
          "currency": "TWD",
          "deposit_type": "pet",
          "payment_type": "unspecified",
          "price": "5",
          "price_unit": "per_room_per_night",
          "pricing_method": "fixed"
        }
      ],
      "extra_bed": [],
      "internet": [],
      "meal": [],
      "no_show": {
        "availability": "unspecified",
        "day_period": "unspecified",
        "time": ""
      },
      "parking": [],
      "pets": [
        {
          "currency": "USD",
          "inclusion": "not_included",
          "pets_type": "unspecified",
          "price": "560",
          "price_unit": "per_room_per_stay"
        }
      ],
      "shuttle": [],
      "visa": {
        "visa_support": "unspecified"
      }
    },
    "name": "Test Hotel (Do Not Book)",
    "payment_methods": [
      "visa",
      "maestro",
      "diners_club",
      "euro_mastercard",
      "cash",
      "mir"
    ],
    "phone": "+49243333333",
    "policy_struct": [
      {
        "paragraphs": [
          "Information about the type of meals included in the price is indicated in the rate details."
        ],
        "title": "Meals"
      },
      {
        "paragraphs": [
          "A deposit of 123.00 HNL per stay will be required at check-in to cover any potential damages.",
          "Keys deposit is required. Cost: 10.00 BAM per room per stay."
        ],
        "title": "Special living conditions"
      },
      {
        "paragraphs": [
          "The given hotel is a fiction and should not be booked. If you book this hotel the further accommodation shall not be provided."
        ],
        "title": "Extra info"
      }
    ],
    "postal_code": "",
    "region": {
      "country_code": "HN",
      "iata": "TGU",
      "id": 3421,
      "name": "Tegucigalpa",
      "type": "City"
    },
    "room_groups": [
      {
        "images": [],
        "images_ext": [],
        "name": "Bed in Dorm",
        "name_struct": {
          "bathroom": "shared bathroom",
          "bedding_type": "",
          "main_name": "Bed in Dorm"
        },
        "rg_ext": {
          "balcony": 0,
          "bathroom": 1,
          "bedding": 0,
          "bedrooms": 0,
          "capacity": 0,
          "class": 1,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 0,
          "sex": 0,
          "view": 0
        },
        "room_amenities": [
          "shared-bathroom"
        ],
        "room_group_id": 6
      },
      {
        "images": [
          "https://cdn.worldota.net/t/{size}/extranet/3a/be/3abe524b9b7216557776102b00ec1c3757daf72f.jpeg",
          "https://cdn.worldota.net/t/{size}/extranet/4e/9b/4e9b3d835f2c14be8b48bf3f0020cbd90db5dabf.png",
          "https://cdn.worldota.net/t/{size}/extranet/f7/c6/f7c6dff491c8e197d5dd9dcc2e8245592384df9f.jpeg",
          "https://cdn.worldota.net/t/{size}/extranet/12/86/128617aabfae1383c08699e0cba00b1dba3bbb8a.png",
          "https://cdn.worldota.net/t/{size}/extranet/48/2c/482c8098b5b2f29c84fcf5a2b941e5255ceb5e24.jpeg",
          "https://cdn.worldota.net/t/{size}/extranet/dc/0c/dc0cf589a83fde0068e6b80011b3f955fca2ff37.png"
        ],
        "images_ext": [
          {
            "category_slug": "unspecified",
            "url": "https://cdn.worldota.net/t/{size}/extranet/3a/be/3abe524b9b7216557776102b00ec1c3757daf72f.jpeg"
          },
          {
            "category_slug": "unspecified",
            "url": "https://cdn.worldota.net/t/{size}/extranet/4e/9b/4e9b3d835f2c14be8b48bf3f0020cbd90db5dabf.png"
          },
          {
            "category_slug": "unspecified",
            "url": "https://cdn.worldota.net/t/{size}/extranet/f7/c6/f7c6dff491c8e197d5dd9dcc2e8245592384df9f.jpeg"
          },
          {
            "category_slug": "unspecified",
            "url": "https://cdn.worldota.net/t/{size}/extranet/12/86/128617aabfae1383c08699e0cba00b1dba3bbb8a.png"
          },
          {
            "category_slug": "unspecified",
            "url": "https://cdn.worldota.net/t/{size}/extranet/48/2c/482c8098b5b2f29c84fcf5a2b941e5255ceb5e24.jpeg"
          },
          {
            "category_slug": "unspecified",
            "url": "https://cdn.worldota.net/t/{size}/extranet/dc/0c/dc0cf589a83fde0068e6b80011b3f955fca2ff37.png"
          }
        ],
        "name": "Standard Double room full double bed",
        "name_struct": {
          "bathroom": "shared bathroom",
          "bedding_type": "full double bed",
          "main_name": "Standard Double room"
        },
        "rg_ext": {
          "balcony": 0,
          "bathroom": 1,
          "bedding": 3,
          "bedrooms": 0,
          "capacity": 2,
          "class": 3,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 2,
          "sex": 0,
          "view": 0
        },
        "room_amenities": [
          "bath",
          "heating",
          "sauna",
          "shared-bathroom",
          "slippers",
          "telephone",
          "toiletries"
        ],
        "room_group_id": 95
      },
      {
        "images": [],
        "images_ext": [],
        "name": "Standard room",
        "name_struct": {
          "bathroom": "",
          "bedding_type": "",
          "main_name": "Standard room"
        },
        "rg_ext": {
          "balcony": 0,
          "bathroom": 2,
          "bedding": 0,
          "bedrooms": 0,
          "capacity": 0,
          "class": 3,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 2,
          "sex": 0,
          "view": 0
        },
        "room_amenities": [
          "private-bathroom"
        ],
        "room_group_id": 11
      },
      {
        "images": [],
        "images_ext": [],
        "name": "Standard Double room full double bed",
        "name_struct": {
          "bathroom": "",
          "bedding_type": "full double bed",
          "main_name": "Standard Double room"
        },
        "rg_ext": {
          "balcony": 0,
          "bathroom": 2,
          "bedding": 3,
          "bedrooms": 0,
          "capacity": 2,
          "class": 3,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 2,
          "sex": 0,
          "view": 0
        },
        "room_amenities": [
          "private-bathroom"
        ],
        "room_group_id": 90
      },
      {
        "images": [
          "https://cdn.worldota.net/t/{size}/extranet/5d/e4/5de47f04eb2a04880b619fac52a5d9d7296cee74.jpeg",
          "https://cdn.worldota.net/t/{size}/extranet/zz/15/ad151c157315d9bd36a9c67bdfdb9784c293b7e9.jpeg"
        ],
        "images_ext": [
          {
            "category_slug": "unspecified",
            "url": "https://cdn.worldota.net/t/{size}/extranet/5d/e4/5de47f04eb2a04880b619fac52a5d9d7296cee74.jpeg"
          },
          {
            "category_slug": "unspecified",
            "url": "https://cdn.worldota.net/t/{size}/extranet/zz/15/ad151c157315d9bd36a9c67bdfdb9784c293b7e9.jpeg"
          }
        ],
        "name": "Deluxe room",
        "name_struct": {
          "bathroom": "",
          "bedding_type": "",
          "main_name": "Deluxe room"
        },
        "rg_ext": {
          "balcony": 0,
          "bathroom": 2,
          "bedding": 0,
          "bedrooms": 0,
          "capacity": 0,
          "class": 3,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 6,
          "sex": 0,
          "view": 0
        },
        "room_amenities": [
          "hairdryer",
          "iron",
          "private-bathroom",
          "shower",
          "telephone",
          "toiletries",
          "tv"
        ],
        "room_group_id": 28
      },
      {
        "images": [
          "https://cdn.worldota.net/t/{size}/extranet/3d/4d/3d4dbaa5a5406f23b014d8e9db79de1d90ae1f72.JPEG",
          "https://cdn.worldota.net/t/{size}/extranet/cb/5c/cb5c32fcbecc04846c2d21e2d7bfe53eaa3f97a8.JPEG",
          "https://cdn.worldota.net/t/{size}/extranet/3a/10/3a10a5fb8f969ffcb049c1ab581aa6ed3bb6a41b.JPEG"
        ],
        "images_ext": [
          {
            "category_slug": "unspecified",
            "url": "https://cdn.worldota.net/t/{size}/extranet/3d/4d/3d4dbaa5a5406f23b014d8e9db79de1d90ae1f72.JPEG"
          },
          {
            "category_slug": "unspecified",
            "url": "https://cdn.worldota.net/t/{size}/extranet/cb/5c/cb5c32fcbecc04846c2d21e2d7bfe53eaa3f97a8.JPEG"
          },
          {
            "category_slug": "unspecified",
            "url": "https://cdn.worldota.net/t/{size}/extranet/3a/10/3a10a5fb8f969ffcb049c1ab581aa6ed3bb6a41b.JPEG"
          }
        ],
        "name": "Deluxe Double room full double bed",
        "name_struct": {
          "bathroom": "",
          "bedding_type": "full double bed",
          "main_name": "Deluxe Double room"
        },
        "rg_ext": {
          "balcony": 0,
          "bathroom": 2,
          "bedding": 3,
          "bedrooms": 0,
          "capacity": 2,
          "class": 3,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 6,
          "sex": 0,
          "view": 0
        },
        "room_amenities": [
          "high-speed-internet-access",
          "private-bathroom",
          "tea",
          "telephone",
          "tv"
        ],
        "room_group_id": 130
      },
      {
        "images": [
          "https://cdn.worldota.net/t/{size}/extranet/78/2e/782e73450732741bc26d2161eb82235add21532e.png"
        ],
        "images_ext": [
          {
            "category_slug": "unspecified",
            "url": "https://cdn.worldota.net/t/{size}/extranet/78/2e/782e73450732741bc26d2161eb82235add21532e.png"
          }
        ],
        "name": "Suite",
        "name_struct": {
          "bathroom": "",
          "bedding_type": "",
          "main_name": "Suite"
        },
        "rg_ext": {
          "balcony": 0,
          "bathroom": 2,
          "bedding": 0,
          "bedrooms": 0,
          "capacity": 0,
          "class": 5,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 0,
          "sex": 0,
          "view": 0
        },
        "room_amenities": [
          "barbecue",
          "fitness",
          "golf",
          "mirror",
          "private-bathroom",
          "safe",
          "telephone",
          "toiletries",
          "towels"
        ],
        "room_group_id": 32
      },
      {
        "images": [
          "https://cdn.worldota.net/t/{size}/extranet/0f/96/0f96b1ba4bf5ee5595aa38581325650c706ad31f.jpeg"
        ],
        "images_ext": [
          {
            "category_slug": "unspecified",
            "url": "https://cdn.worldota.net/t/{size}/extranet/0f/96/0f96b1ba4bf5ee5595aa38581325650c706ad31f.jpeg"
          }
        ],
        "name": "Apartment with balcony",
        "name_struct": {
          "bathroom": "",
          "bedding_type": "",
          "main_name": "Apartment with balcony"
        },
        "rg_ext": {
          "balcony": 1,
          "bathroom": 2,
          "bedding": 0,
          "bedrooms": 0,
          "capacity": 0,
          "class": 6,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 0,
          "sex": 0,
          "view": 0
        },
        "room_amenities": [
          "golf",
          "kitchen",
          "private-bathroom",
          "sauna"
        ],
        "room_group_id": 18395671
      },
      {
        "images": [
          "https://cdn.worldota.net/t/{size}/extranet/c2/6a/c26ad3e0e12fe393d6f545851ed33c0d643ead28.jpeg"
        ],
        "images_ext": [
          {
            "category_slug": "unspecified",
            "url": "https://cdn.worldota.net/t/{size}/extranet/c2/6a/c26ad3e0e12fe393d6f545851ed33c0d643ead28.jpeg"
          }
        ],
        "name": "6 Bedrooms Villa",
        "name_struct": {
          "bathroom": "",
          "bedding_type": "",
          "main_name": "6 Bedrooms Villa"
        },
        "rg_ext": {
          "balcony": 0,
          "bathroom": 2,
          "bedding": 0,
          "bedrooms": 6,
          "capacity": 0,
          "class": 8,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 0,
          "sex": 0,
          "view": 0
        },
        "room_amenities": [
          "private-bathroom"
        ],
        "room_group_id": 18395673
      }
    ],
    "serp_filters": [
      "has_internet",
      "has_parking",
      "has_meal",
      "has_business",
      "has_spa",
      "has_pets",
      "has_jacuzzi",
      "kitchen"
    ],
    "star_certificate": null,
    "star_rating": 4
  },
  "debug": null,
  "error": null,
  "status": "ok"
}

Errors

hotel_not_found

The hotel isn’t found.