Retrieve hotel content

ETG API V3

B2B API

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

ℹ️

Either Numeric hotel identifier (HID) field or the Alphabetic hotel identifier (ID) field is required.

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

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

Expand this| Collapse this

id String required or optional

The unique hotel ID in the legacy string format.

ℹ️

Either this field or the hid field is required.

hid Int required or optional

The unique hotel ID in the new numeric format.

ℹ️

Each ID is an integer no longer than 10 digits.
We are gradually migrating all clients to use this format.

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 Bokmål.
pl — Polish.
pt — Portuguese.
pt_PT — European Portuguese.
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

Expand this| Collapse this

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.

ℹ️

Store and display it in the UI, but do not index it or use it for internal search queries or SEO.

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 in the legacy string format.

ℹ️

Either this field or the hid field is required.

hid Int

The unique hotel ID in the new numeric format.

ℹ️

Each ID is an integer no longer than 10 digits.
We are gradually migrating all clients to use this format.

images [String]

The list of the URLs for the hotel images.

ℹ️

The recommended method for displaying these images in our UI (e.g., direct linking to the provided URLs).
We do not block users arbitrarily; restrictions are only applied in case of suspected DDoS attacks.
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-w — the image is scaled so that its width fits the given value, and the height is adjusted proportionally.
  - fit-w-min — the image is scaled so that its width is at least the specified value (if it’s smaller, it is enlarged; if it’s larger, it is reduced), while the height is adjusted proportionally. No cropping occurs.
  - fit — the image is fit into the rectangle by the size in question.
- The possible values:
  - 1024x768 — fit.
  - x220 — fit-h.
  - x500 — fit-h.
  - x768 — fit-h.
  - 40x40 — crop.
  - 80x80 — crop.
  - 100x100 — crop.
  - 120x120 — crop.
  - 241x241 — crop.
  - 240x240 — crop.
  - 154x105 — crop.
  - 170x154 — crop.
  - 640x350 — crop.
  - 320x175 — crop.
  - 200x200 — crop.
  - 1080x522 — crop.
  - 750x400 — crop.
  - 640x400 — crop.
  - 120x90 — crop.
  - 90x75 — crop.
  - x300 — fit-h.
  - x600 — fit-h.
  - 100x130 — crop.
  - x296 — fit-h.
  - 100x50 — crop.
  - x100 — fit-h.
  - 100x — fit-w.
  - 640x230 — crop.
  - 370x — fit-w.
  - 645x255 — crop.
  - 450x161 — crop.
  - x102 — fit-h.
  - 225x60 — fit.
  - 828x560 — fit.
  - 640x640 — crop.
  - 196x196 — crop.
  - 1298x — fit-w.
  - 295x220 — crop.
  - 2048x2048 — crop.
  - 304x — fit-w.
  - 304x140 — crop.
  - x700 — fit-h.
  - 112x112 — crop.
  - 695x — fit-w-min.
  - 1300x620 — fit-w.
  - 2600x1240 — fit-w.
  - 600x313 — fit-w.
  - 1200x616 — fit-w.
  - 326x220 — fit-w.
  - 768x1024 — fit-h.
  - 900x900 — crop.
  - 1920x1080 — fit.
  - 1080x1920 — fit-h.
  - x1080 — fit-h.
  - x1920 — fit-h.
  - 1920x — fit-w.
  - 1080x — fit-w.

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.

ℹ️

The recommended method for displaying these images in our UI (e.g., direct linking to the provided URLs).
We do not block users arbitrarily; restrictions are only applied in case of suspected DDoS attacks.
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-w — the image is scaled so that its width fits the given value, and the height is adjusted proportionally.
  - fit-w-min — the image is scaled so that its width is at least the specified value (if it’s smaller, it is enlarged; if it’s larger, it is reduced), while the height is adjusted proportionally. No cropping occurs.
  - fit — the image is fit into the rectangle by the size in question.
- The possible values:
  - 1024x768 — fit.
  - x220 — fit-h.
  - x500 — fit-h.
  - x768 — fit-h.
  - 40x40 — crop.
  - 80x80 — crop.
  - 100x100 — crop.
  - 120x120 — crop.
  - 241x241 — crop.
  - 240x240 — crop.
  - 154x105 — crop.
  - 170x154 — crop.
  - 640x350 — crop.
  - 320x175 — crop.
  - 200x200 — crop.
  - 1080x522 — crop.
  - 750x400 — crop.
  - 640x400 — crop.
  - 120x90 — crop.
  - 90x75 — crop.
  - x300 — fit-h.
  - x600 — fit-h.
  - 100x130 — crop.
  - x296 — fit-h.
  - 100x50 — crop.
  - x100 — fit-h.
  - 100x — fit-w.
  - 640x230 — crop.
  - 370x — fit-w.
  - 645x255 — crop.
  - 450x161 — crop.
  - x102 — fit-h.
  - 225x60 — fit.
  - 828x560 — fit.
  - 640x640 — crop.
  - 196x196 — crop.
  - 1298x — fit-w.
  - 295x220 — crop.
  - 2048x2048 — crop.
  - 304x — fit-w.
  - 304x140 — crop.
  - x700 — fit-h.
  - 112x112 — crop.
  - 695x — fit-w-min.
  - 1300x620 — fit-w.
  - 2600x1240 — fit-w.
  - 600x313 — fit-w.
  - 1200x616 — fit-w.
  - 326x220 — fit-w.
  - 768x1024 — fit-h.
  - 900x900 — crop.
  - 1920x1080 — fit.
  - 1080x1920 — fit-h.
  - x1080 — fit-h.
  - x1920 — fit-h.
  - 1920x — fit-w.
  - 1080x — fit-w.

kind String

The hotel type.

ℹ️

The possible values:

Unspecified,
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 beds’ 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 meals’ 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 adult 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 adult meals’ 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-show 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 for the embassy of the hotel country.

ℹ️

The possible values:

unspecified — no information on the visa support.
support_enable — the visa supported is available.

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.

ℹ️

The recommended method for displaying these images in our UI (e.g., direct linking to the provided URLs).
We do not block users arbitrarily; restrictions are only applied in case of suspected DDoS attacks.
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-w — the image is scaled so that its width fits the given value, and the height is adjusted proportionally.
  - fit-w-min — the image is scaled so that its width is at least the specified value (if it’s smaller, it is enlarged; if it’s larger, it is reduced), while the height is adjusted proportionally. No cropping occurs.
  - fit — the image is fit into the rectangle by the size in question.
- The possible values:
  - 1024x768 — fit.
  - x220 — fit-h.
  - x500 — fit-h.
  - x768 — fit-h.
  - 40x40 — crop.
  - 80x80 — crop.
  - 100x100 — crop.
  - 120x120 — crop.
  - 241x241 — crop.
  - 240x240 — crop.
  - 154x105 — crop.
  - 170x154 — crop.
  - 640x350 — crop.
  - 320x175 — crop.
  - 200x200 — crop.
  - 1080x522 — crop.
  - 750x400 — crop.
  - 640x400 — crop.
  - 120x90 — crop.
  - 90x75 — crop.
  - x300 — fit-h.
  - x600 — fit-h.
  - 100x130 — crop.
  - x296 — fit-h.
  - 100x50 — crop.
  - x100 — fit-h.
  - 100x — fit-w.
  - 640x230 — crop.
  - 370x — fit-w.
  - 645x255 — crop.
  - 450x161 — crop.
  - x102 — fit-h.
  - 225x60 — fit.
  - 828x560 — fit.
  - 640x640 — crop.
  - 196x196 — crop.
  - 1298x — fit-w.
  - 295x220 — crop.
  - 2048x2048 — crop.
  - 304x — fit-w.
  - 304x140 — crop.
  - x700 — fit-h.
  - 112x112 — crop.
  - 695x — fit-w-min.
  - 1300x620 — fit-w.
  - 2600x1240 — fit-w.
  - 600x313 — fit-w.
  - 1200x616 — fit-w.
  - 326x220 — fit-w.
  - 768x1024 — fit-h.
  - 900x900 — crop.
  - 1920x1080 — fit.
  - 1080x1920 — fit-h.
  - x1080 — fit-h.
  - x1920 — fit-h.
  - 1920x — fit-w.
  - 1080x — fit-w.

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.

ℹ️

The recommended method for displaying these images in our UI (e.g., direct linking to the provided URLs).
We do not block users arbitrarily; restrictions are only applied in case of suspected DDoS attacks.
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-w — the image is scaled so that its width fits the given value, and the height is adjusted proportionally.
  - fit-w-min — the image is scaled so that its width is at least the specified value (if it’s smaller, it is enlarged; if it’s larger, it is reduced), while the height is adjusted proportionally. No cropping occurs.
  - fit — the image is fit into the rectangle by the size in question.
- The possible values:
  - 1024x768 — fit.
  - x220 — fit-h.
  - x500 — fit-h.
  - x768 — fit-h.
  - 40x40 — crop.
  - 80x80 — crop.
  - 100x100 — crop.
  - 120x120 — crop.
  - 241x241 — crop.
  - 240x240 — crop.
  - 154x105 — crop.
  - 170x154 — crop.
  - 640x350 — crop.
  - 320x175 — crop.
  - 200x200 — crop.
  - 1080x522 — crop.
  - 750x400 — crop.
  - 640x400 — crop.
  - 120x90 — crop.
  - 90x75 — crop.
  - x300 — fit-h.
  - x600 — fit-h.
  - 100x130 — crop.
  - x296 — fit-h.
  - 100x50 — crop.
  - x100 — fit-h.
  - 100x — fit-w.
  - 640x230 — crop.
  - 370x — fit-w.
  - 645x255 — crop.
  - 450x161 — crop.
  - x102 — fit-h.
  - 225x60 — fit.
  - 828x560 — fit.
  - 640x640 — crop.
  - 196x196 — crop.
  - 1298x — fit-w.
  - 295x220 — crop.
  - 2048x2048 — crop.
  - 304x — fit-w.
  - 304x140 — crop.
  - x700 — fit-h.
  - 112x112 — crop.
  - 695x — fit-w-min.
  - 1300x620 — fit-w.
  - 2600x1240 — fit-w.
  - 600x313 — fit-w.
  - 1200x616 — fit-w.
  - 326x220 — fit-w.
  - 768x1024 — fit-h.
  - 900x900 — crop.
  - 1920x1080 — fit.
  - 1080x1920 — fit-h.
  - x1080 — fit-h.
  - x1920 — fit-h.
  - 1920x — fit-w.
  - 1080x — fit-w.

name String

The full room name.

room_amenities [String]

The room amenities 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 true 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.

Information about the hotel registration in the FSA register.

Applicable only for hotels in some specific countries.

Has the null value if there is no information about the registration.

record String

Registration number in the FSA register.

link String

Link to the FSA register.

status String

Status of the object in the FSA register. Determines whether the object can be displayed and sold. Possible values:

Active — the object can be both displayed and sold.
Suspended — the object can be displayed, but selling is not available.
Terminated — the object cannot be displayed or sold.
Unspecified — status is unknown, used for unexpected values from an external source.

phone String

The hotel phone number in the FSA register.

email String

The hotel email address in the FSA register.

rooms Object

Information about hotel rooms from the FSA register.

rooms_count Int

Number of rooms by category.

category_type String

Name of room categories.

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"
        ],
        "non_free_amenities": null,
        "group_name": "General"
      },
      {
        "amenities": [
          "Cable TV",
          "Locker"
        ],
        "non_free_amenities": null,
        "group_name": "Rooms"
      },
      {
        "amenities": [
          "Concierge services",
          "Dry-cleaning",
          "Shoe shine"
        ],
        "non_free_amenities": [
          "Dry-cleaning",
          "Shoe shine"
        ],
        "group_name": "Services and amenities"
      },
      {
        "amenities": [
          "Breakfast",
          "Common kitchen",
          "Restaurant",
          "Kitchen"
        ],
        "non_free_amenities": null,
        "group_name": "Meals"
      },
      {
        "amenities": [
          "Internet access"
        ],
        "non_free_amenities": null,
        "group_name": "Internet"
      },
      {
        "amenities": [
          "Car rental"
        ],
        "non_free_amenities": [
          "Car rental"
        ],
        "group_name": "Transfer"
      },
      {
        "amenities": [
          "Barbeque"
        ],
        "non_free_amenities": null,
        "group_name": "Recreation"
      },
      {
        "amenities": [
          "Parking nearby"
        ],
        "non_free_amenities": [
          "Parking nearby"
        ],
        "group_name": "Parking"
      },
      {
        "amenities": [
          "Spa tub"
        ],
        "non_free_amenities": null,
        "group_name": "Pool and beach"
      },
      {
        "amenities": [
          "Conference Hall"
        ],
        "non_free_amenities": null,
        "group_name": "Business"
      },
      {
        "amenities": [
          "Squash"
        ],
        "non_free_amenities": null,
        "group_name": "Sports"
      },
      {
        "amenities": [
          "Pets allowed (free)"
        ],
        "non_free_amenities": null,
        "group_name": "Pets"
      }
    ],
    "check_in_time": "14:00:00",
    "check_out_time": "12:00:00",
    "description_struct": [
      {
        "paragraphs": [
          "A perfect fit for a big group of travellers: apartment «Test Hotel (Do Not Book) test» is located in Tegucigalpa. This apartment is located in 3 km from the city center."
        ],
        "title": "Location"
      },
      {
        "paragraphs": [
          "It’s time to have a nice meal! Stop by the restaurant. If you travel by car, there’s a paid parking zone at the apartment. You won’t be bored as at the apartment you will find a barbeque area. For participants of business meetings, there is a conference hall.",
          "You won’t have to leave your pet at home as they are allowed for free. Accessible for guests with disabilities: the elevator helps them to go to the highest floors. There are other services available for the guests of the apartment. For example, dry cleaning, car rental and a concierge."
        ],
        "title": "At the apartment"
      }
    ],
    "email": "<[email protected]>",
    "hotel_chain": "No chain",
    "hid": 8473727,
    "id": "test_hotel_do_not_book",
    "images_ext": [
      {
        "url": "https://cdn.worldota.net/t/{size}/extranet/b5/d3/b5d3d33394494c68321246882c1bd93a6832dcd5.jpeg",
        "category_slug": "others"
      },
      {
        "url": "https://cdn.worldota.net/t/{size}/extranet/15/44/15440558c952ec4c3488730d1563dc9e8d25832c.JPEG",
        "category_slug": "outside"
      },
      {
        "url": "https://cdn.worldota.net/t/{size}/extranet/cf/cd/cfcd60bc8fc0cab8fa26c3c63617d541cf1175ee.jpeg",
        "category_slug": "others"
      },
      {
        "url": "https://cdn.worldota.net/t/{size}/extranet/6e/5b/6e5b761eaa9e07abfd997ec02d84fa7cf2229fa7.jpeg",
        "category_slug": "others"
      },
      {
        "url": "https://cdn.worldota.net/t/{size}/extranet/13/11/13115f9ec6d13ae5a3e9b5afdb693e7f22cfcfe0.jpeg",
        "category_slug": "outside"
      },
      {
        "url": "https://cdn.worldota.net/t/{size}/extranet/11/80/118098dc06238834a9becb33546314a61fc50ff7.jpeg",
        "category_slug": "outside"
      },
      {
        "url": "https://cdn.worldota.net/t/{size}/extranet/55/0f/550f03096f8bf9f458bc8662f2dc4d870ba8f853.jpeg",
        "category_slug": "others"
      }
    ],
    "kind": "Apartment",
    "latitude": 14.079872,
    "longitude": -87.21677,
    "name": "Test Hotel (Do Not Book) test",
    "metapolicy_struct": {
      "add_fee": [],
      "check_in_check_out": [],
      "children": [
        {
          "age_end": 3,
          "age_start": 0,
          "currency": "CHF",
          "extra_bed": "available",
          "price": 500
        },
        {
          "age_end": 9,
          "age_start": 4,
          "currency": "ALL",
          "extra_bed": "available",
          "price": 700
        },
        {
          "age_end": 12,
          "age_start": 10,
          "currency": "",
          "extra_bed": "available",
          "price": 0
        }
      ],
      "children_meal": [
        {
          "age_end": 5,
          "age_start": 0,
          "currency": "USD",
          "inclusion": "not_included",
          "meal_type": "breakfast",
          "price": 200
        },
        {
          "age_end": 12,
          "age_start": 6,
          "currency": "USD",
          "inclusion": "not_included",
          "meal_type": "breakfast",
          "price": 400
        }
      ],
      "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": [
        {
          "amount": 1,
          "currency": "ALL",
          "inclusion": "not_included",
          "price": 100,
          "price_unit": "per_guest_per_night"
        }
      ],
      "internet": [
        {
          "currency": "",
          "inclusion": "included",
          "internet_type": "unspecified",
          "price": 0,
          "price_unit": "unspecified",
          "work_area": "hotel"
        },
        {
          "currency": "USD",
          "inclusion": "not_included",
          "internet_type": "unspecified",
          "price": 1,
          "price_unit": "per_hour",
          "work_area": "room"
        }
      ],
      "meal": [
        {
          "currency": "USD",
          "inclusion": "not_included",
          "meal_type": "breakfast",
          "price": 300
        },
        {
          "currency": "USD",
          "inclusion": "not_included",
          "meal_type": "lunch",
          "price": 500
        }
      ],
      "no_show": {
        "availability": "available",
        "day_period": "after_midday",
        "time": "09:00:00"
      },
      "parking": [
        {
          "currency": "USD",
          "inclusion": "not_included",
          "territory_type": "unspecified",
          "price": 100,
          "price_unit": "per_car_per_night"
        }
      ],
      "pets": [
        {
          "currency": "USD",
          "inclusion": "not_included",
          "pets_type": "unspecified",
          "price": 560,
          "price_unit": "per_room_per_stay"
        }
      ],
      "shuttle": [
        {
          "currency": "EUR",
          "inclusion": "not_included",
          "shuttle_type": "one_way",
          "price": 100,
          "destination_type": "train"
        },
        {
          "currency": "EUR",
          "inclusion": "not_included",
          "shuttle_type": "one_way",
          "price": 200,
          "destination_type": "airport"
        },
        {
          "currency": "",
          "inclusion": "included",
          "shuttle_type": "unspecified",
          "price": 0,
          "destination_type": "airport_train"
        }
      ],
      "visa": {
        "visa_support": "support_enable"
      }
    },
    "metapolicy_extra_info": "Front desk is open 24/7.\nThe given hotel is a fiction and should not be booked. If you book this hotel the further accommodation shall not be provided.",
    "phone": "+49243333333",
    "policy_struct": [
      {
        "paragraphs": [
          "Price of an additional breakfast: 300.00 USD per person. Information about the type of meals included in the price is indicated in the rate details."
        ],
        "title": "Meals"
      },
      {
        "paragraphs": [
          "Fee for an extra bed: 100.00 ALL per night.",
          "The number of extra beds depends on the room category. You must take a look at the information about the size of the selected room.",
          "Breakfast for children aged 0-5 costs: 200.00 USD.",
          "Breakfast for children aged 6-12 costs: 400.00 USD.",
          "Children from the age of 0 to 3 can stay in additional beds (child bed/cot) for a charge of 500.00 CHF a night providing they share a room with their parents or guardians. Additional beds (child bed/cot) available on request.",
          "Children from the age of 4 to 9 can stay in additional beds (child bed/cot) for a charge of 700.00 ALL a night providing they share a room with their parents or guardians. Additional beds (child bed/cot) available on request.",
          "Children from the age of 10 to 12 can stay free of charge providing they share a room with their parents or guardians, in the existing beds."
        ],
        "title": "Children and information about extra beds"
      },
      {
        "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.",
          "You can request the documents necessary for a visa, the service is provided for an additional fee. Any additional fee will have to be paid even if the booking is subsequently cancelled, and all the agreements exist exclusively between you and the provider of the documents.",
          "Attention! If you do not check in to your room before 9:00 PM at night, the booking will be cancelled."
        ],
        "title": "Special living conditions"
      },
      {
        "paragraphs": [
          "Chargeable parking available. Cost: 100.00 USD per day."
        ],
        "title": "Parking space"
      },
      {
        "paragraphs": [
          "Transfer from/to railway station available. Cost: 100.00 EUR one way.",
          "Transfer from/to airport available. Cost: 200.00 EUR one way."
        ],
        "title": "Transfer"
      },
      {
        "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": [
      {
        "name": "Bed in Dorm ",
        "images": null,
        "images_ext": [],
        "name_struct": {
          "bathroom": "shared bathroom",
          "bedding_type": "",
          "main_name": "Bed in Dorm"
        },
        "room_amenities": [
          "shared-bathroom"
        ],
        "room_group_id": 6,
        "rg_ext": {
          "balcony": 0,
          "bathroom": 1,
          "bedding": 0,
          "bedrooms": 0,
          "capacity": 0,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 0,
          "class": 1,
          "sex": 0,
          "view": 0
        }
      },
      {
        "name": "Standard Double room full double bed",
        "images": [
          "https://cdn.worldota.net/t/{size}/extranet/3a/be/3abe524b9b7216557776102b00ec1c3757daf72f.jpeg",
          "https://cdn.worldota.net/t/{size}/extranet/e8/f4/e8f40eaf38b682c54a53335e07a4328785955f14.JPEG",
          "https://cdn.worldota.net/t/{size}/extranet/f7/c6/f7c6dff491c8e197d5dd9dcc2e8245592384df9f.jpeg",
          "https://cdn.worldota.net/t/{size}/extranet/d8/ef/d8efcb8e230c6d53a95da50dc4167c1350b2db39.JPEG",
          "https://cdn.worldota.net/t/{size}/extranet/48/2c/482c8098b5b2f29c84fcf5a2b941e5255ceb5e24.jpeg",
          "https://cdn.worldota.net/t/{size}/extranet/4d/b5/4db591d6c861e226aa83b8e38ccd4f57c5364e34.JPEG"
        ],
        "images_ext": [
          {
            "url": "https://cdn.worldota.net/t/{size}/extranet/3a/be/3abe524b9b7216557776102b00ec1c3757daf72f.jpeg",
            "category_slug": "unspecified"
          },
          {
            "url": "https://cdn.worldota.net/t/{size}/extranet/e8/f4/e8f40eaf38b682c54a53335e07a4328785955f14.JPEG",
            "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/d8/ef/d8efcb8e230c6d53a95da50dc4167c1350b2db39.JPEG",
            "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/4d/b5/4db591d6c861e226aa83b8e38ccd4f57c5364e34.JPEG",
            "category_slug": "unspecified"
          }
        ],
        "name_struct": {
          "bathroom": "shared bathroom",
          "bedding_type": "full double bed",
          "main_name": "Standard Double room"
        },
        "room_amenities": [
          "bath",
          "heating",
          "sauna",
          "shared-bathroom",
          "slippers",
          "telephone",
          "toiletries"
        ],
        "room_group_id": 95,
        "rg_ext": {
          "balcony": 0,
          "bathroom": 1,
          "bedding": 3,
          "bedrooms": 0,
          "capacity": 2,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 2,
          "class": 3,
          "sex": 0,
          "view": 0
        }
      },
      {
        "name": "Standard room ",
        "images": null,
        "images_ext": [],
        "name_struct": {
          "bathroom": "",
          "bedding_type": "",
          "main_name": "Standard room"
        },
        "room_amenities": [
          "private-bathroom"
        ],
        "room_group_id": 11,
        "rg_ext": {
          "balcony": 0,
          "bathroom": 2,
          "bedding": 0,
          "bedrooms": 0,
          "capacity": 0,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 2,
          "class": 3,
          "sex": 0,
          "view": 0
        }
      },
      {
        "name": "Standard Double room full double bed",
        "images": null,
        "images_ext": [],
        "name_struct": {
          "bathroom": "",
          "bedding_type": "full double bed",
          "main_name": "Standard Double room"
        },
        "room_amenities": [
          "private-bathroom"
        ],
        "room_group_id": 90,
        "rg_ext": {
          "balcony": 0,
          "bathroom": 2,
          "bedding": 3,
          "bedrooms": 0,
          "capacity": 2,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 2,
          "class": 3,
          "sex": 0,
          "view": 0
        }
      },
      {
        "name": "Deluxe room ",
        "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": [
          {
            "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",
            "category_slug": "unspecified"
          }
        ],
        "name_struct": {
          "bathroom": "",
          "bedding_type": "",
          "main_name": "Deluxe room"
        },
        "room_amenities": [
          "hairdryer",
          "iron",
          "private-bathroom",
          "shower",
          "telephone",
          "toiletries",
          "tv"
        ],
        "room_group_id": 28,
        "rg_ext": {
          "balcony": 0,
          "bathroom": 2,
          "bedding": 0,
          "bedrooms": 0,
          "capacity": 0,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 6,
          "class": 3,
          "sex": 0,
          "view": 0
        }
      },
      {
        "name": "Deluxe Double room full double bed",
        "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": [
          {
            "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",
            "category_slug": "unspecified"
          }
        ],
        "name_struct": {
          "bathroom": "",
          "bedding_type": "full double bed",
          "main_name": "Deluxe Double room"
        },
        "room_amenities": [
          "high-speed-internet-access",
          "private-bathroom",
          "tea",
          "telephone",
          "tv"
        ],
        "room_group_id": 130,
        "rg_ext": {
          "balcony": 0,
          "bathroom": 2,
          "bedding": 3,
          "bedrooms": 0,
          "capacity": 2,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 6,
          "class": 3,
          "sex": 0,
          "view": 0
        }
      },
      {
        "name": "Suite ",
        "images": [
          "https://cdn.worldota.net/t/{size}/extranet/78/2e/782e73450732741bc26d2161eb82235add21532e.png"
        ],
        "images_ext": [
          {
            "url": "https://cdn.worldota.net/t/{size}/extranet/78/2e/782e73450732741bc26d2161eb82235add21532e.png",
            "category_slug": "unspecified"
          }
        ],
        "name_struct": {
          "bathroom": "",
          "bedding_type": "",
          "main_name": "Suite"
        },
        "room_amenities": [
          "barbecue",
          "fitness",
          "golf",
          "mirror",
          "private-bathroom",
          "safe",
          "telephone",
          "toiletries",
          "towels"
        ],
        "room_group_id": 32,
        "rg_ext": {
          "balcony": 0,
          "bathroom": 2,
          "bedding": 0,
          "bedrooms": 0,
          "capacity": 0,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 0,
          "class": 5,
          "sex": 0,
          "view": 0
        }
      },
      {
        "name": "Apartment with balcony ",
        "images": [
          "https://cdn.worldota.net/t/{size}/extranet/0f/96/0f96b1ba4bf5ee5595aa38581325650c706ad31f.jpeg"
        ],
        "images_ext": [
          {
            "url": "https://cdn.worldota.net/t/{size}/extranet/0f/96/0f96b1ba4bf5ee5595aa38581325650c706ad31f.jpeg",
            "category_slug": "unspecified"
          }
        ],
        "name_struct": {
          "bathroom": "",
          "bedding_type": "",
          "main_name": "Apartment with balcony"
        },
        "room_amenities": [
          "golf",
          "kitchen",
          "private-bathroom",
          "sauna"
        ],
        "room_group_id": 18395671,
        "rg_ext": {
          "balcony": 1,
          "bathroom": 2,
          "bedding": 0,
          "bedrooms": 0,
          "capacity": 0,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 0,
          "class": 6,
          "sex": 0,
          "view": 0
        }
      },
      {
        "name": "6 Bedrooms Villa ",
        "images": [
          "https://cdn.worldota.net/t/{size}/extranet/c2/6a/c26ad3e0e12fe393d6f545851ed33c0d643ead28.jpeg"
        ],
        "images_ext": [
          {
            "url": "https://cdn.worldota.net/t/{size}/extranet/c2/6a/c26ad3e0e12fe393d6f545851ed33c0d643ead28.jpeg",
            "category_slug": "unspecified"
          }
        ],
        "name_struct": {
          "bathroom": "",
          "bedding_type": "",
          "main_name": "6 Bedrooms Villa"
        },
        "room_amenities": [
          "private-bathroom"
        ],
        "room_group_id": 18395673,
        "rg_ext": {
          "balcony": 0,
          "bathroom": 2,
          "bedding": 0,
          "bedrooms": 6,
          "capacity": 0,
          "club": 0,
          "family": 0,
          "floor": 0,
          "quality": 0,
          "class": 8,
          "sex": 0,
          "view": 0
        }
      }
    ],
    "star_rating": 4,
    "serp_filters": [
      "has_internet",
      "has_parking",
      "has_meal",
      "has_business",
      "has_spa",
      "has_pets",
      "has_jacuzzi",
      "kitchen"
    ],
    "star_certificate": {
      "valid_to": "",
      "certificate_id": ""
    },
    "is_closed": false,
    "facts": {
      "electricity": {
        "frequency": [
          60
        ],
        "voltage": null,
        "sockets": [
          "a",
          "b"
        ]
      },
      "kind": "",
      "star_rating": 0,
      "type": "",
      "floors_number": 0,
      "rooms_number": 0,
      "year_built": 0,
      "year_renovated": 0,
      "register": {
        "record": "",
        "link": "",
        "email": "",
        "phone": "",
        "status": "",
        "rooms": []
      }
    },
    "payment_methods": [
      "visa",
      "maestro",
      "diners_club",
      "euro_master_card",
      "cash",
      "mir"
    ],
    "front_desk_time_start": "00:00:00",
    "front_desk_time_end": "00:00:00",
    "is_gender_specification_required": false,
    "deleted": false,
    "keys_pickup": {
      "type": "lockbox",
      "phone": "+49243333333",
      "is_contactless": true,
      "email": "<[email protected]>",
      "apartment_office_address": "",
      "apartment_extra_information": "The keys are in the box by the front door."
    },
    "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/11/80/118098dc06238834a9becb33546314a61fc50ff7.jpeg",
      "https://cdn.worldota.net/t/{size}/extranet/55/0f/550f03096f8bf9f458bc8662f2dc4d870ba8f853.jpeg"
    ]
  },
  "debug": {
    "api_endpoint": {
      "endpoint": "api/b2b/v3/hotel/info",
      "is_active": true,
      "is_limited": true,
      "remaining": 29,
      "requests_number": 30,
      "reset": "2025-09-11T09:58:00",
      "seconds_number": 60
    },
    "request": {
      "hid": "8473727",
      "language": "en"
    },
    "method": "POST",
    "real_ip": "95.55.113.250",
    "request_id": "02b7edee15e2291a68332f668563e7df",
    "key_id": 1234,
    "api_key_id": 1234,
    "utcnow": "2025-09-11T09:57:04.501411"
  },
  "status": "ok",
  "error": null
}

Errors

`hotel_not_found`

The hotel isn’t found.

`unknown`

The error occurs if something else has gone wrong.