Search by hotel IDs

ETG API V3

Hotel search

Search by hotel IDs

🆕

The Sandbox environment is available exclusively to new partners who begin their integration in Q4 2025.

https://api-sandbox.worldota.net/api/b2b/v3/search/serp/hotels/

ℹ️

This call is required.

The call gets hotels’ rates by the SERP mechanism.

⚠️

Let users choose the rates from this call response isn’t recommended.
A full match with a response from the Retrieve hotelpage request isn’t expected.

Sandbox limitations

⚠️

Use all field values and API keys obtained from the sandbox environment only within the sandbox. Don’t mix them with test or production environments.

Request

language. The field value is always en.
currency. The field value is always USD.

Response

hotels.rates. The maximum items’ number is 5.
Not supported fields:
- hotels.rates.payment_options.payment_types.cancellation_penalties.policies.commission_info.charge.amount_gross.
- hotels.rates.payment_options.payment_types.cancellation_penalties.policies.commission_info.charge.amount_commission.

Errors

Internal search errors aren’t supported.

Request example

curl --user '<KEY_ID>:<API_KEY>' 'https://api-sandbox.worldota.net/api/b2b/v3/search/serp/hotels/' \
--header 'Content-Type: application/json' \
--data '{
    "checkin": "2025-10-17",
    "checkout": "2025-10-22",
    "residency": "gb",
    "language": "en",
    "guests": [
        {
            "adults": 2,
            "children": []
        }
    ],
    "hids": 
    [
        10595223, 
        10654204
    ],
    "currency": "USD"
}'

Request body

Expand this| Collapse this

checkin String required

The check-in date. The value must be not later than 730 days from the day when the request is made.

checkout String required

The check-out date. The value must be not later than 30 days from the checkin field value.

currency String optional

The currency of all rooms’ prices.

If passed, the show_amount and show_currency_amount fields will have the currency of this field.

ℹ️

The default value is the contract currency for prepaid rates.

ids [String] required

The list of the unique hotel IDs.

ℹ️

Either this field or the hid field is required.

hids [Int] required

The list of most preferred hotel IDs.

ℹ️

The ID maximum length is 10 characters.

language String optional

The hotel data language.

ℹ️

The default value is the contract 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.

residency String required or optional

The guests’ citizenship in the ISO 3166-1 alpha-2 format.

Use this field if there are doubts regarding the country or the hotel policy towards citizens.

ℹ️

The possible values:

ad — Andorra.
ae — United Arab Emirates.
af — Afghanistan.
ag — Antigua and Barbuda.
ai — Anguilla.
al — Albania.
am — Armenia.
ao — Angola.
aq — Antarctica.
ar — Argentina.
as — American Samoa.
at — Austria.
au — Australia.
aw — Aruba.
ax — Åland Islands.
az — Azerbaijan.
ba — Bosnia and Herzegovina.
bb — Barbados.
bd — Bangladesh.
be — Belgium.
bf — Burkina Faso.
bg — Bulgaria.
bh — Bahrain.
bi — Burundi.
bj — Benin.
bl — Saint Barthélemy.
bm — Bermuda.
bn — Brunei Darussalam.
bo — Bolivia.
bq — Bonaire, Sint Eustatius and Saba.
br — Brazil.
bs — Bahamas.
bt — Bhutan.
bv — Bouvet Island.
bw — Botswana.
by — Belarus.
bz — Belize.
ca — Canada.
cc — Cocos (Keeling) Islands.
cd — Democratic Republic of the Congo, also known as Congo-Kinshasa.
cf — Central African Republic.
cg — The Republic of the Congo, also known as Congo-Brazzaville.
ch — Switzerland.
ci — Côte d’Ivoire.
ck — Cook Islands.
cl — Chile.
cm — Cameroon.
cn — China.
co — Colombia.
cr — Costa Rica.
cu — Cuba.
cv — Cabo Verde.
cw — Curaçao.
cx — Christmas Island.
cy — Cyprus.
cz — Czechia.
de — Germany.
dj — Djibouti.
dk — Denmark.
dm — Dominica.
do — Dominican Republic.
dz — Algeria.
ec — Ecuador.
ee — Estonia.
eg — Egypt.
eh — Western Sahara.
er — Eritrea.
es — Spain.
et — Ethiopia.
fi — Finland.
fj — Fiji.
fk — Falkland Islands (Malvinas).
fm — Micronesia.
fo — Faroe Islands.
fr — France.
ga — Gabon.
gb — United Kingdom of Great Britain and Northern Ireland.
gd — Grenada.
ge — Georgia.
gf — French Guiana.
gg — Guernsey.
gh — Ghana.
gi — Gibraltar.
gl — Greenland.
gm — Gambia.
gn — Guinea.
gp — Guadeloupe.
gq — Equatorial Guinea.
gr — Greece.
gs — South Georgia and the South Sandwich Islands.
gt — Guatemala.
gu — Guam.
gw — Guinea-Bissau.
gy — Guyana.
hk — Hong Kong.
hm — Heard Island and McDonald Islands.
hn — Honduras.
hr — Croatia.
ht — Haiti.
hu — Hungary.
id — Indonesia.
ie — Ireland.
il — Israel.
im — Isle of Man.
in — India.
io — British Indian Ocean Territory.
iq — Iraq.
ir — Iran.
is — Iceland.
it — Italy.
je — Bailiwick of Jersey.
jm — Jamaica.
jo — Jordan.
jp — Japan.
ke — Kenya.
kg — Kyrgyzstan.
kh — Cambodia.
ki — Kiribati.
km — Comoros.
kn — Saint Kitts and Nevis.
kp — North Korea.
kr — South Korea.
kw — Kuwait.
ky — Cayman Islands.
kz — Kazakhstan.
la — Laos.
lb — Lebanon.
lc — Saint Lucia.
li — Liechtenstein.
lk — Sri Lanka.
lr — Liberia.
ls — Lesotho.
lt — Lithuania.
lu — Luxembourg.
lv — Latvia.
ly — Libya.
ma — Morocco.
mc — Monaco.
md — Moldova.
me — Montenegro.
mf — Saint Martin.
mg — Madagascar.
mh — Marshall Islands.
mk — North Macedonia.
ml — Mali.
mm — Myanmar.
mn — Mongolia.
mo — Macao.
mp — Northern Mariana Islands.
mq — Martinique.
mr — Mauritania.
ms — Montserrat.
mt — Malta.
mu — Mauritius.
mv — Maldives.
mw — Malawi.
mx — Mexico.
my — Malaysia.
mz — Mozambique.
na — Namibia.
nc — New Caledonia.
ne — Niger.
nf — Norfolk Island.
ng — Nigeria.
ni — Nicaragua.
nl — Netherlands.
no — Norway.
np — Nepal.
nr — Nauru.
nu — Niue.
nz — New Zealand.
om — Oman.
pa — Panama.
pe — Peru.
pf — French Polynesia.
pg — Papua New Guinea.
ph — Philippines.
pk — Pakistan.
pl — Poland.
pm — Saint Pierre and Miquelon.
pn — Pitcairn.
pr — Puerto Rico.
ps — Palestine.
pt — Portugal.
pw — Palau.
py — Paraguay.
qa — Qatar.
re — Réunion.
ro — Romania.
rs — Serbia.
ru — Russian Federation.
rw — Rwanda.
sa — Saudi Arabia.
sb — Solomon Islands.
sc — Seychelles.
sd — Sudan.
se — Sweden.
sg — Singapore.
sh — Saint Helena, Ascension and Tristan da Cunha.
si — Slovenia.
sj — Svalbard and Jan Mayen.
sk — Slovakia.
sl — Sierra Leone.
sm — San Marino.
sn — Senegal.
so — Somalia.
sr — Suriname.
ss — South Sudan.
st — Sao Tome and Principe.
sv — El Salvador.
sx — Sint Maarten.
sy — Syrian Arab Republic.
sz — Eswatini.
tc — Turks and Caicos Islands.
td — Chad.
tf — French Southern Territories.
tg — Togo.
th — Thailand.
tj — Tajikistan.
tk — Tokelau.
tl — Timor-Leste.
tm — Turkmenistan.
tn — Tunisia.
to — Tonga.
tr — Turkey.
tt — Trinidad and Tobago.
tv — Tuvalu.
tw — Taiwan.
tz — Tanzania.
ua — Ukraine.
ug — Uganda.
um — United States Minor Outlying Islands.
us — United States of America.
uy — Uruguay.
uz — Uzbekistan.
va — Holy See.
vc — Saint Vincent and the Grenadines.
ve — Venezuela.
vg — Virgin Islands (British).
vi — Virgin Islands (U.S.).
vn — Vietnam.
vu — Vanuatu.
wf — Wallis and Futuna.
ws — Samoa.
xk — Kosovo.
ye — Yemen.
yt — Mayotte.
za — South Africa.
zm — Zambia.
zw — Zimbabwe.

timeout Float optional

The maximum amount of time in seconds within which searching for rates will be executed.

ℹ️

The maximum value is 100.

guests [Object] optional

The list of guests in the rooms.

ℹ️

One list item represents one room.
The maximum number of guests per room is 6.
The maximum number of rooms per request is 9.
The multiroom search:
- Each request should have from 2 to 9 rooms.
- A request may contain rooms with different number of guests.
- Once the request is sent, you can’t:
  - Change the number of guests or rooms.
  - Cancel one of the guests or rooms.
The ETG API returns rooms suitable for the maximum number of the requested guests.

adults Int required

The number of adult guests in one room.

ℹ️

The minimum value is 1.
The maximum value is 6.

children [Int] optional

The age list of the children who will stay in the room.

ℹ️

The maximum age per child is 17 years.
The maximum number of children in the room is 4.

upsells Object optional

Whether additional services are needed or not.

⚠️

Set these parameters only when the user really needs additional services.
Only one early check-in and one late check-out should be requested and selected.

ℹ️

For step-by-step instructions and code examples on processing this field, see Upsells.

early_checkin Object optional

Whether early check-in is needed or not.

time String optional

The early check-in time.

late_checkout Object optional

Whether late check-out is needed or not.

time String optional

The late check-out time.

only_eclc Boolean optional

Whether the rates with only early check-in or late check-out are needed or not.

Response

Expand this| Collapse this

total_hotels Int

The total number of unique hotels.

hotels [Object]

The list of hotels and their rates.

id String

The unique hotel ID in the legacy string format.

ℹ️

Either this field or the hid field is required.

hids 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.

rates [Object]

The list of available hotel rates.

allotment Int

The number of rooms available for the rate.

amenities_data [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.

any_residency Boolean

Whether the rate is allowed to be booked by the guest with any kind of residency or not.

Use it if you don’t collect the guests’ residency.

search_hash String

The unique search rate ID used to identify the selected rate.

ℹ️

Use this value in the hash field of the Prebook rate from search step call.
The value lifetime is 6 hours after you have got the rate from the search results.

daily_prices [String]

The list of daily rate prices breakdown in the request currency.

deposit Object

The deposit information of the order.

Has a value if the rate payment_types.type field has the hotel value.

amount String

The deposit amount.

currency_code String

The deposit amount currency code. Is the same as the charged (hotel) currency code.

is_refundable Boolean

Whether the deposit is refundable or not.

match_hash String

The match_hash field of the rate from the call made by the SERP mechanism.

Use this field if you are:

Showing rates to the users from the call made by the SERP mechanism.
Making a booking from these rates.
Using this call response as actual data on the rate.
Using this call response to actualize the exact rate from the calls made by the SERP mechanism.

Usage of this field can help the ETG collect analytics for SERP-HP matching.

meal String

deprecated

⚠️

Use the meal_data field instead.

The meal type.

If there is no meal type provided by the rate source, the nomeal value is returned.

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

meal_data Object

The rate meals information.

value String

The meal type in the rate.

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

Has the nomeal value if no meal type is provided.

has_breakfast Boolean

Whether breakfast is included to the rate or not.

no_child_meal Boolean

Whether the children meal is absent in the rate or not.

no_show Object

The no-show penalty information.

amount String

The no-show penalty amount.

currency_code String

The no-show penalty amount currency code. Is the same as the charged (hotel) currency code.

from_time String

The time in the hotel timezone from which amount would be charged for the no-show penalty in the HH:MM:SS format.

payment_options Object

The accepted payment options with the specified amount to be charged.

For a booking, this amount in the requested currency should be paid.

payment_types String

The list with accepted payment options.

amount String

The amount to be charged for the booking in the contract currency code.

by String

Whether the booking can be paid by a card or not.

cancellation_penalties String

The cancellation rules and commission information.

free_cancellation_before String

The date and time when the free cancellation policy expires.

Has the null value, if there is no free cancellation.

The timezone is in UTC±0.

policies String

The cancellation policies breakdown by periods.

amount_charge String

The cancellation penalty amount in the contract currency.

amount_show String

The cancellation penalty amount in the request currency.

commission_info [Object]

The commission information.

charge [Object]

The commission information in the charge (contract) currency.

amount_commission String

The commission amount.

amount_gross String

The gross price.

amount_net String

The net price.

show [Object]

The commission information in the requested currency.

amount_commission String

The commission amount.

amount_gross String

The gross price.

amount_net String

The net price.

end_at String

The date and time when this cancellation policy expires.

Has the null value, if it is in the time from the start_at field value till check-in.

If the start_at and end_at fields have the null value, this particular cancellation policy:

Has no time restrictions.
Is in effect all the time.

The timezone is in UTC±0.

start_at String

The date and time when this cancellation policy takes effect.

Has the null value, if it is in effect till the end_at field value.

The timezone is in UTC±0.

commission_info [Object]

The commission information.

charge [Object]

The commission information in the charge (contract) currency.

amount_commission String

The commission amount.

amount_gross String

The gross price.

amount_net String

The net price.

show [Object]

The commission information in the requested currency.

amount_commission String

The commission amount.

amount_gross String

The gross price.

amount_net String

The net price.

currency_code String

The amount currency code. Is the same as the charged (contract) currency code.

is_need_credit_card_data Boolean

Whether the credit card information is needed or not.

is_need_cvc Boolean

Whether the CVC is needed or not.

show_amount String

The rate price in the request currency code of this object show_currency_code field value.

Isn’t necessarily the sum in the charged or payment currency code.

show_currency_code String

The currency code in the request body.

perks String

The additional services’ information.

early_checkin [Object]

The early check-in information.

charge_price String

The early check-in amount in the charge (contract) currency.

commission_info [Object]

The commission information.

charge [Object]

The commission information in the charge (contract) currency.

amount_commission String

The commission amount.

amount_gross String

The gross price.

amount_net String

The net price.

show [Object]

The commission information in the requested currency.

amount_commission String

The commission amount.

amount_gross String

The gross price.

amount_net String

The net price.

is_requested Boolean

Whether the early check-in is requested or not.

show_price String

The early check-in amount in the search currency.

time String

The early check-in time.

late_checkout [Object]

The late check-out information.

charge_price String

The late check-out amount in the charge (contract) currency.

commission_info [Object]

The commission information.

charge [Object]

The commission information in the charge (contract) currency.

amount_commission String

The commission amount.

amount_gross String

The gross price.

amount_net String

The net price.

show [Object]

The commission information in the requested currency.

amount_commission String

The commission amount.

amount_gross String

The gross price.

amount_net String

The net price.

is_requested Boolean

Whether the late check-out is requested or not.

show_price String

The late check-out amount in the search currency.

time String

The late check-out time.

recommended_price String

⚠️

This parameter is currently under development and will be available later. It can be ignored at the moment.

The price below which the rate can’t be sold on B2C website.

amount String

The deposit amount.

currency_code String

The deposit amount currency code. Is the same as the charged (hotel) currency code.

show_amount String

The rate price in the request currency code of this object show_currency_code field value.

Isn’t necessarily the sum in the charged or payment currency code.

show_currency_code String

The request currency code.

Isn’t necessarily in the charged or payment currency code.

tax_data Object

The tax information.

taxes Object

The taxes list.

amount String

The tax amount.

currency_code String

The tax amount currency code in the ISO 4217 format.

ℹ️

The length is 3 characters.
The possible values:
- AED.
- AFN.
- ALL.
- AMD.
- ANG.
- AOA.
- ARS.
- AUD.
- AWG.
- AZN.
- BAM.
- BBD.
- BDT.
- BGN.
- BHD.
- BIF.
- BMD.
- BND.
- BOB.
- BOV.
- BRL.
- BSD.
- BTN.
- BWP.
- BYR.
- BYN.
- BZD.
- CAD.
- CDF.
- CHE.
- CHF.
- CHW.
- CLF.
- CLP.
- CNY.
- COP.
- COU.
- CRC.
- CUC.
- CUP.
- CVE.
- CZK.
- DJF.
- DKK.
- DOP.
- DZD.
- EGP.
- ERN.
- ETB.
- EUR.
- FJD.
- FKP.
- GBP.
- GEL.
- GHS.
- GIP.
- GMD.
- GNF.
- GTQ.
- GYD.
- HKD.
- HNL.
- HRK.
- HTG.
- HUF.
- IDR.
- ILS.
- INR.
- IQD.
- IRR.
- ISK.
- JMD.
- JOD.
- JPY.
- KES.
- KGS.
- KHR.
- KMF.
- KPW.
- KRW.
- KWD.
- KYD.
- KZT.
- LAK.
- LBP.
- LKR.
- LRD.
- LSL.
- LTL.
- LVL.
- LYD.
- MAD.
- MDL.
- MGA.
- MKD.
- MMK.
- MNT.
- MOP.
- MRO.
- MUR.
- MVR.
- MWK.
- MXN.
- MXV.
- MYR.
- MZN.
- NAD.
- NGN.
- NIO.
- NOK.
- NPR.
- NZD.
- OMR.
- PAB.
- PEN.
- PGK.
- PHP.
- PKR.
- PLN.
- PYG.
- QAR.
- RON.
- RSD.
- RUB.
- RWF.
- SAR.
- SBD.
- SCR.
- SDG.
- SEK.
- SGD.
- SHP.
- SLL.
- SOS.
- SRD.
- SSP.
- STD.
- SVC.
- SYP.
- SZL.
- THB.
- TJS.
- TMT.
- TND.
- TOP.
- TRY.
- TTD.
- TWD.
- TZS.
- UAH.
- UGX.
- USD.
- USN.
- USS.
- UYI.
- UYU.
- UZS.
- VEF.
- VND.
- VUV.
- WST.
- XAF.
- XAG.
- XAU.
- XBA.
- XBB.
- XBC.
- XBD.
- XCD.
- XDR.
- XFU.
- XOF.
- XPD.
- XPF.
- XPT.
- XSU.
- XTS.
- XUA.
- YER.
- ZAR.
- ZMW.
- ZWL.

included_by_supplier Boolean

Whether the tax is included by the supplier or not.

When it has:

The false value, the tax is supposed to be paid at the hotel in this object currency.
The true value, the tax is included in the price.

name String

The ETG tax ID.

To get all available tax IDs and their definitions, use the taxes field from the Retrieve hotel static data call.

type String

The payment type.

ℹ️

The possible values:
- now. Use it to allow the user to pay for the booking via the ETG payment system:
  1. Request the Create booking process call and get the card details.
  2. Request the Create credit card token call with the card details.
- deposit. Use it to allow you to charge the user bank card for the booking by yourself:
  1. You need to keep your ETG deposit sufficient. To increase funds, contact your account manager.
  2. The user makes a booking.
  3. You charge the user bank card.
  4. The ETG writes funds from your deposit by themselves during the reporting period.
  Every payment goes under a credit limit for the deposit.

vat_data Object

The rate VAT information.

amount String

The VAT amount.

applied Boolean

Whether the VAT is applied or not.

currency_code String

The amount currency code in the ISO 4217 format.

ℹ️

The length is 3 characters.
The possible values:
- AED.
- AFN.
- ALL.
- AMD.
- ANG.
- AOA.
- ARS.
- AUD.
- AWG.
- AZN.
- BAM.
- BBD.
- BDT.
- BGN.
- BHD.
- BIF.
- BMD.
- BND.
- BOB.
- BOV.
- BRL.
- BSD.
- BTN.
- BWP.
- BYR.
- BYN.
- BZD.
- CAD.
- CDF.
- CHE.
- CHF.
- CHW.
- CLF.
- CLP.
- CNY.
- COP.
- COU.
- CRC.
- CUC.
- CUP.
- CVE.
- CZK.
- DJF.
- DKK.
- DOP.
- DZD.
- EGP.
- ERN.
- ETB.
- EUR.
- FJD.
- FKP.
- GBP.
- GEL.
- GHS.
- GIP.
- GMD.
- GNF.
- GTQ.
- GYD.
- HKD.
- HNL.
- HRK.
- HTG.
- HUF.
- IDR.
- ILS.
- INR.
- IQD.
- IRR.
- ISK.
- JMD.
- JOD.
- JPY.
- KES.
- KGS.
- KHR.
- KMF.
- KPW.
- KRW.
- KWD.
- KYD.
- KZT.
- LAK.
- LBP.
- LKR.
- LRD.
- LSL.
- LTL.
- LVL.
- LYD.
- MAD.
- MDL.
- MGA.
- MKD.
- MMK.
- MNT.
- MOP.
- MRO.
- MUR.
- MVR.
- MWK.
- MXN.
- MXV.
- MYR.
- MZN.
- NAD.
- NGN.
- NIO.
- NOK.
- NPR.
- NZD.
- OMR.
- PAB.
- PEN.
- PGK.
- PHP.
- PKR.
- PLN.
- PYG.
- QAR.
- RON.
- RSD.
- RUB.
- RWF.
- SAR.
- SBD.
- SCR.
- SDG.
- SEK.
- SGD.
- SHP.
- SLL.
- SOS.
- SRD.
- SSP.
- STD.
- SVC.
- SYP.
- SZL.
- THB.
- TJS.
- TMT.
- TND.
- TOP.
- TRY.
- TTD.
- TWD.
- TZS.
- UAH.
- UGX.
- USD.
- USN.
- USS.
- UYI.
- UYU.
- UZS.
- VEF.
- VND.
- VUV.
- WST.
- XAF.
- XAG.
- XAU.
- XBA.
- XBB.
- XBC.
- XBD.
- XCD.
- XDR.
- XFU.
- XOF.
- XPD.
- XPF.
- XPT.
- XSU.
- XTS.
- XUA.
- YER.
- ZAR.
- ZMW.
- ZWL.

included Boolean

Whether the VAT is included or not.

value Float

deprecated

The VAT amount in the currency of this object currency_code field value.

bar_rate_price_data Object

Contains information about the BAR (Best Available Rate), which is the lowest publicly available rate for a hotel room.

ℹ️

This field is available only upon request. Please contact your account manager if you need access to this data.

amount String

The BAR price value. It represents the lowest publicly available price for a room.

currency_code String

Currency of the BAR price.

rg_ext Object

The hotel room type.

Use this field to get extra data on the room from the hotel static data. For example, room images, descriptions.

balcony Int

Whether there is a balcony or not.

ℹ️

The possible values:

0 — no balcony.
1 — a balcony.

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.

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.

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 — sextuplet.

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.

club Int

Whether it is a club room or not.

ℹ️

The possible values:

0 — not a club room.
1 — a club room.

family Int

Whether it is a family room or not.

ℹ️

The possible values:

0 — not a family room.
1 — a family room.

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.

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.

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.

room_data_trans Object

The room information in the request language.

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.

main_room_type String

The room type.

misc_room_type String

The room additional information.

legal_info Object

The hotel and service provider legal information.

ℹ️

The information provided depends on the supplier of the specific rate.

Has the value different from null for only countries where it is mandatory to have this information.

Has the null value for the calls made by the SERP mechanism.

hotel Object

The hotel legal information.

name String

The hotel legal name.

address String

The hotel legal address.

taxpayer_number String

The Taxpayer Personal Identification Number (INN) of the hotel.

ℹ️

The length is 10 characters.

state_registration_number String

The State Registration Number for Companies (OGRN) of the hotel.

ℹ️

The length is 13 characters.

work_time String

The hotel legal address working hours.

provider Object

The service provider legal information.

name String

The service provider legal name.

address String

The service provider legal address.

taxpayer_number String

The Taxpayer Personal Identification Number (INN) of the service provider.

ℹ️

The length is 10 characters.

state_registration_number String

The State Registration Number for Companies (OGRN) of the service provider.

ℹ️

The length is 13 characters.

is_package Boolean

Rates marked with is_package = true should be sold as a part of package, and the price for the hotel should not be shown separately.

room_name String

The room name in the request language.

room_name_info Object

The optional object that may help to resolve certain matching problems. To get access to the object, contact your account manager.

sell_price_limits Object

Information on the restrictions on the final selling price for the client.

ℹ️

This field is available only upon request. Please contact your account manager if you need access to this data.

If not null, the final selling price should be:

Within the min_price and max_price field values.
In the search currency.

min_price String

The minimum final selling price for the client in the search currency.

max_price String

The maximum final selling price for the client in the search currency.

serp_filters [String]

The list of hotel amenities.

Response example

{
  "data": {
    "hotels": [
      {
        "id": "key_view_the_residences",
        "hid": 10595223,
        "rates": [
          {
            "match_hash": "m-bae5055c-73be-53eb-949e-c7b1a4db403f",
            "search_hash": "sr-01998009-2889-7d6e-ae98-7433aaeedf02",
            "daily_prices": [
              "90.00",
              "90.00",
              "90.00",
              "90.00",
              "90.00"
            ],
            "meal": "nomeal",
            "meal_data": {
              "value": "nomeal",
              "has_breakfast": false,
              "no_child_meal": true
            },
            "payment_options": {
              "payment_types": [
                {
                  "amount": "385.80",
                  "show_amount": "450.00",
                  "currency_code": "EUR",
                  "show_currency_code": "USD",
                  "by": null,
                  "is_need_credit_card_data": false,
                  "is_need_cvc": false,
                  "type": "deposit",
                  "vat_data": {
                    "included": false,
                    "applied": false,
                    "amount": "0.00",
                    "currency_code": "USD",
                    "value": "0.00"
                  },
                  "tax_data": {
                    "taxes": [
                      {
                        "name": "city_tax",
                        "included_by_supplier": false,
                        "amount": "19.29",
                        "currency_code": "HNL"
                      },
                      {
                        "name": "occupancy_tax",
                        "included_by_supplier": false,
                        "amount": "15.43",
                        "currency_code": "HNL"
                      },
                      {
                        "name": "resort_fee",
                        "included_by_supplier": true,
                        "amount": "7.71",
                        "currency_code": "USD"
                      },
                      {
                        "name": "service_fee",
                        "included_by_supplier": true,
                        "amount": "38.58",
                        "currency_code": "USD"
                      }
                    ]
                  },
                  "perks": {},
                  "commission_info": {
                    "show": {
                      "amount_gross": "450.00",
                      "amount_net": "450.00",
                      "amount_commission": "0.00"
                    },
                    "charge": {
                      "amount_gross": "385.81",
                      "amount_net": "385.81",
                      "amount_commission": "0.00"
                    }
                  },
                  "cancellation_penalties": {
                    "policies": [
                      {
                        "start_at": null,
                        "end_at": "2025-10-16T00:00:00",
                        "amount_charge": "0.00",
                        "amount_show": "0.00",
                        "commission_info": {
                          "show": {
                            "amount_gross": "0.00",
                            "amount_net": "0.00",
                            "amount_commission": "0.00"
                          },
                          "charge": {
                            "amount_gross": "0.00",
                            "amount_net": "0.00",
                            "amount_commission": "0.00"
                          }
                        }
                      },
                      {
                        "start_at": "2025-10-16T00:00:00",
                        "end_at": null,
                        "amount_charge": "385.80",
                        "amount_show": "450.00",
                        "commission_info": {
                          "show": {
                            "amount_gross": "500.00",
                            "amount_net": "450.00",
                            "amount_commission": "50.00"
                          },
                          "charge": {
                            "amount_gross": "428.68",
                            "amount_net": "385.81",
                            "amount_commission": "42.87"
                          }
                        }
                      }
                    ],
                    "free_cancellation_before": "2025-10-16T00:00:00"
                  },
                  "recommended_price": null
                }
              ]
            },
            "bar_rate_price_data": null,
            "rg_ext": {
              "class": 4,
              "quality": 0,
              "sex": 0,
              "bathroom": 1,
              "bedding": 1,
              "family": 0,
              "capacity": 2,
              "club": 0,
              "bedrooms": 0,
              "balcony": 0,
              "view": 0,
              "floor": 0
            },
            "room_name": "Junior Suite",
            "room_name_info": null,
            "serp_filters": [
              "has_bathroom"
            ],
            "sell_price_limits": null,
            "allotment": 2,
            "amenities_data": [
              "king-bed",
              "non-smoking"
            ],
            "any_residency": true,
            "deposit": null,
            "no_show": {
              "amount": "0.00",
              "currency_code": "USD",
              "from_time": "00:00:00"
            },
            "room_data_trans": {
              "main_room_type": "Junior Suite",
              "main_name": "Junior Suite",
              "bathroom": null,
              "bedding_type": null,
              "misc_room_type": null
            },
            "legal_info": null,
            "is_package": false
          },
          {
            "match_hash": "m-418790a2-a525-5218-91e9-1d367f356b1f",
            "search_hash": "sr-01998009-2889-7d77-9573-e99e99a2f80e",
            "daily_prices": [
              "92.00",
              "92.00",
              "92.00",
              "92.00",
              "92.00"
            ],
            "meal": "breakfast-buffet",
            "meal_data": {
              "value": "breakfast-buffet",
              "has_breakfast": true,
              "no_child_meal": false
            },
            "payment_options": {
              "payment_types": [
                {
                  "amount": "394.38",
                  "show_amount": "460.00",
                  "currency_code": "EUR",
                  "show_currency_code": "USD",
                  "by": null,
                  "is_need_credit_card_data": false,
                  "is_need_cvc": false,
                  "type": "deposit",
                  "vat_data": {
                    "included": false,
                    "applied": false,
                    "amount": "0.00",
                    "currency_code": "USD",
                    "value": "0.00"
                  },
                  "tax_data": {
                    "taxes": [
                      {
                        "name": "city_tax",
                        "included_by_supplier": false,
                        "amount": "19.71",
                        "currency_code": "HNL"
                      },
                      {
                        "name": "occupancy_tax",
                        "included_by_supplier": false,
                        "amount": "15.77",
                        "currency_code": "HNL"
                      },
                      {
                        "name": "resort_fee",
                        "included_by_supplier": true,
                        "amount": "7.88",
                        "currency_code": "USD"
                      },
                      {
                        "name": "service_fee",
                        "included_by_supplier": true,
                        "amount": "39.43",
                        "currency_code": "USD"
                      }
                    ]
                  },
                  "perks": {},
                  "commission_info": {
                    "show": {
                      "amount_gross": "460.00",
                      "amount_net": "460.00",
                      "amount_commission": "0.00"
                    },
                    "charge": {
                      "amount_gross": "394.38",
                      "amount_net": "394.38",
                      "amount_commission": "0.00"
                    }
                  },
                  "cancellation_penalties": {
                    "policies": [
                      {
                        "start_at": null,
                        "end_at": "2025-10-15T00:00:00",
                        "amount_charge": "0.00",
                        "amount_show": "0.00",
                        "commission_info": {
                          "show": {
                            "amount_gross": "0.00",
                            "amount_net": "0.00",
                            "amount_commission": "0.00"
                          },
                          "charge": {
                            "amount_gross": "0.00",
                            "amount_net": "0.00",
                            "amount_commission": "0.00"
                          }
                        }
                      },
                      {
                        "start_at": "2025-10-15T00:00:00",
                        "end_at": "2025-10-16T00:00:00",
                        "amount_charge": "197.19",
                        "amount_show": "230.00",
                        "commission_info": {
                          "show": {
                            "amount_gross": "255.56",
                            "amount_net": "230.00",
                            "amount_commission": "25.56"
                          },
                          "charge": {
                            "amount_gross": "219.10",
                            "amount_net": "197.19",
                            "amount_commission": "21.91"
                          }
                        }
                      },
                      {
                        "start_at": "2025-10-16T00:00:00",
                        "end_at": null,
                        "amount_charge": "394.38",
                        "amount_show": "460.00",
                        "commission_info": {
                          "show": {
                            "amount_gross": "511.11",
                            "amount_net": "460.00",
                            "amount_commission": "51.11"
                          },
                          "charge": {
                            "amount_gross": "438.20",
                            "amount_net": "394.38",
                            "amount_commission": "43.82"
                          }
                        }
                      }
                    ],
                    "free_cancellation_before": "2025-10-15T00:00:00"
                  },
                  "recommended_price": null
                }
              ]
            },
            "bar_rate_price_data": null,
            "rg_ext": {
              "class": 4,
              "quality": 0,
              "sex": 0,
              "bathroom": 1,
              "bedding": 1,
              "family": 0,
              "capacity": 2,
              "club": 0,
              "bedrooms": 0,
              "balcony": 0,
              "view": 0,
              "floor": 0
            },
            "room_name": "Junior Suite",
            "room_name_info": null,
            "serp_filters": [
              "has_breakfast",
              "has_bathroom"
            ],
            "sell_price_limits": null,
            "allotment": 2,
            "amenities_data": [
              "king-bed",
              "non-smoking"
            ],
            "any_residency": true,
            "deposit": null,
            "no_show": {
              "amount": "0.00",
              "currency_code": "USD",
              "from_time": "00:00:00"
            },
            "room_data_trans": {
              "main_room_type": "Junior Suite",
              "main_name": "Junior Suite",
              "bathroom": null,
              "bedding_type": null,
              "misc_room_type": null
            },
            "legal_info": null,
            "is_package": false
          },
          {
            "match_hash": "m-8779c5b4-1072-5af9-9a07-3f7cfea6c38e",
            "search_hash": "sr-01998009-2889-7d7a-9fcf-6f8898c23937",
            "daily_prices": [
              "114.00",
              "114.00",
              "114.00",
              "114.00",
              "114.00"
            ],
            "meal": "breakfast-buffet",
            "meal_data": {
              "value": "breakfast-buffet",
              "has_breakfast": true,
              "no_child_meal": false
            },
            "payment_options": {
              "payment_types": [
                {
                  "amount": "488.69",
                  "show_amount": "570.00",
                  "currency_code": "EUR",
                  "show_currency_code": "USD",
                  "by": null,
                  "is_need_credit_card_data": false,
                  "is_need_cvc": false,
                  "type": "deposit",
                  "vat_data": {
                    "included": false,
                    "applied": false,
                    "amount": "0.00",
                    "currency_code": "USD",
                    "value": "0.00"
                  },
                  "tax_data": {
                    "taxes": [
                      {
                        "name": "city_tax",
                        "included_by_supplier": false,
                        "amount": "24.43",
                        "currency_code": "HNL"
                      },
                      {
                        "name": "occupancy_tax",
                        "included_by_supplier": false,
                        "amount": "19.54",
                        "currency_code": "HNL"
                      },
                      {
                        "name": "resort_fee",
                        "included_by_supplier": true,
                        "amount": "9.77",
                        "currency_code": "USD"
                      },
                      {
                        "name": "service_fee",
                        "included_by_supplier": true,
                        "amount": "48.86",
                        "currency_code": "USD"
                      }
                    ]
                  },
                  "perks": {},
                  "commission_info": {
                    "show": {
                      "amount_gross": "570.00",
                      "amount_net": "570.00",
                      "amount_commission": "0.00"
                    },
                    "charge": {
                      "amount_gross": "488.69",
                      "amount_net": "488.69",
                      "amount_commission": "0.00"
                    }
                  },
                  "cancellation_penalties": {
                    "policies": [
                      {
                        "start_at": null,
                        "end_at": null,
                        "amount_charge": "488.69",
                        "amount_show": "570.00",
                        "commission_info": {
                          "show": {
                            "amount_gross": "633.33",
                            "amount_net": "570.00",
                            "amount_commission": "63.33"
                          },
                          "charge": {
                            "amount_gross": "542.99",
                            "amount_net": "488.69",
                            "amount_commission": "54.30"
                          }
                        }
                      }
                    ],
                    "free_cancellation_before": null
                  },
                  "recommended_price": null
                }
              ]
            },
            "bar_rate_price_data": null,
            "rg_ext": {
              "class": 5,
              "quality": 0,
              "sex": 0,
              "bathroom": 1,
              "bedding": 1,
              "family": 0,
              "capacity": 2,
              "club": 0,
              "bedrooms": 0,
              "balcony": 0,
              "view": 0,
              "floor": 0
            },
            "room_name": "Suite",
            "room_name_info": null,
            "serp_filters": [
              "has_breakfast",
              "has_bathroom"
            ],
            "sell_price_limits": null,
            "allotment": 2,
            "amenities_data": [
              "king-bed",
              "non-smoking"
            ],
            "any_residency": true,
            "deposit": null,
            "no_show": {
              "amount": "0.00",
              "currency_code": "USD",
              "from_time": "00:00:00"
            },
            "room_data_trans": {
              "main_room_type": "Suite",
              "main_name": "Suite",
              "bathroom": null,
              "bedding_type": null,
              "misc_room_type": null
            },
            "legal_info": null,
            "is_package": false
          }
        ],
        "bar_price_data": null
      },
      {
        "id": "staycae_upper_crest_downtown_view",
        "hid": 10654204,
        "rates": [
          {
            "match_hash": "m-9a4c5859-2dba-5b43-905a-b5c3e04a7ea8",
            "search_hash": "sr-01998009-2889-7d76-8e21-d3b3c25eb724",
            "daily_prices": [
              "116.00",
              "116.00",
              "116.00",
              "116.00",
              "116.00"
            ],
            "meal": "nomeal",
            "meal_data": {
              "value": "nomeal",
              "has_breakfast": false,
              "no_child_meal": true
            },
            "payment_options": {
              "payment_types": [
                {
                  "amount": "497.26",
                  "show_amount": "580.00",
                  "currency_code": "EUR",
                  "show_currency_code": "USD",
                  "by": null,
                  "is_need_credit_card_data": false,
                  "is_need_cvc": false,
                  "type": "deposit",
                  "vat_data": {
                    "included": false,
                    "applied": false,
                    "amount": "0.00",
                    "currency_code": "USD",
                    "value": "0.00"
                  },
                  "tax_data": {
                    "taxes": [
                      {
                        "name": "city_tax",
                        "included_by_supplier": false,
                        "amount": "24.86",
                        "currency_code": "HNL"
                      },
                      {
                        "name": "occupancy_tax",
                        "included_by_supplier": false,
                        "amount": "19.89",
                        "currency_code": "HNL"
                      },
                      {
                        "name": "resort_fee",
                        "included_by_supplier": true,
                        "amount": "9.94",
                        "currency_code": "USD"
                      },
                      {
                        "name": "service_fee",
                        "included_by_supplier": true,
                        "amount": "49.72",
                        "currency_code": "USD"
                      }
                    ]
                  },
                  "perks": {},
                  "commission_info": {
                    "show": {
                      "amount_gross": "580.00",
                      "amount_net": "580.00",
                      "amount_commission": "0.00"
                    },
                    "charge": {
                      "amount_gross": "497.27",
                      "amount_net": "497.27",
                      "amount_commission": "0.00"
                    }
                  },
                  "cancellation_penalties": {
                    "policies": [
                      {
                        "start_at": null,
                        "end_at": "2025-10-16T00:00:00",
                        "amount_charge": "0.00",
                        "amount_show": "0.00",
                        "commission_info": {
                          "show": {
                            "amount_gross": "0.00",
                            "amount_net": "0.00",
                            "amount_commission": "0.00"
                          },
                          "charge": {
                            "amount_gross": "0.00",
                            "amount_net": "0.00",
                            "amount_commission": "0.00"
                          }
                        }
                      },
                      {
                        "start_at": "2025-10-16T00:00:00",
                        "end_at": null,
                        "amount_charge": "497.26",
                        "amount_show": "580.00",
                        "commission_info": {
                          "show": {
                            "amount_gross": "644.44",
                            "amount_net": "580.00",
                            "amount_commission": "64.44"
                          },
                          "charge": {
                            "amount_gross": "552.52",
                            "amount_net": "497.27",
                            "amount_commission": "55.25"
                          }
                        }
                      }
                    ],
                    "free_cancellation_before": "2025-10-16T00:00:00"
                  },
                  "recommended_price": null
                }
              ]
            },
            "bar_rate_price_data": null,
            "rg_ext": {
              "class": 4,
              "quality": 0,
              "sex": 0,
              "bathroom": 1,
              "bedding": 1,
              "family": 0,
              "capacity": 2,
              "club": 0,
              "bedrooms": 0,
              "balcony": 0,
              "view": 0,
              "floor": 0
            },
            "room_name": "Junior Suite",
            "room_name_info": null,
            "serp_filters": [
              "has_bathroom"
            ],
            "sell_price_limits": null,
            "allotment": 2,
            "amenities_data": [
              "king-bed",
              "non-smoking"
            ],
            "any_residency": true,
            "deposit": null,
            "no_show": {
              "amount": "0.00",
              "currency_code": "USD",
              "from_time": "00:00:00"
            },
            "room_data_trans": {
              "main_room_type": "Junior Suite",
              "main_name": "Junior Suite",
              "bathroom": null,
              "bedding_type": null,
              "misc_room_type": null
            },
            "legal_info": null,
            "is_package": false
          },
          {
            "match_hash": "m-fc3a4d40-4eda-5c52-8569-65df054e8e1e",
            "search_hash": "sr-01998009-2889-7d73-ba3d-4c44411fb62f",
            "daily_prices": [
              "118.00",
              "118.00",
              "118.00",
              "118.00",
              "118.00"
            ],
            "meal": "breakfast-buffet",
            "meal_data": {
              "value": "breakfast-buffet",
              "has_breakfast": true,
              "no_child_meal": false
            },
            "payment_options": {
              "payment_types": [
                {
                  "amount": "505.83",
                  "show_amount": "590.00",
                  "currency_code": "EUR",
                  "show_currency_code": "USD",
                  "by": null,
                  "is_need_credit_card_data": false,
                  "is_need_cvc": false,
                  "type": "deposit",
                  "vat_data": {
                    "included": false,
                    "applied": false,
                    "amount": "0.00",
                    "currency_code": "USD",
                    "value": "0.00"
                  },
                  "tax_data": {
                    "taxes": [
                      {
                        "name": "city_tax",
                        "included_by_supplier": false,
                        "amount": "25.29",
                        "currency_code": "HNL"
                      },
                      {
                        "name": "occupancy_tax",
                        "included_by_supplier": false,
                        "amount": "20.23",
                        "currency_code": "HNL"
                      },
                      {
                        "name": "resort_fee",
                        "included_by_supplier": true,
                        "amount": "10.11",
                        "currency_code": "USD"
                      },
                      {
                        "name": "service_fee",
                        "included_by_supplier": true,
                        "amount": "50.58",
                        "currency_code": "USD"
                      }
                    ]
                  },
                  "perks": {},
                  "commission_info": {
                    "show": {
                      "amount_gross": "590.00",
                      "amount_net": "590.00",
                      "amount_commission": "0.00"
                    },
                    "charge": {
                      "amount_gross": "505.84",
                      "amount_net": "505.84",
                      "amount_commission": "0.00"
                    }
                  },
                  "cancellation_penalties": {
                    "policies": [
                      {
                        "start_at": null,
                        "end_at": "2025-10-15T00:00:00",
                        "amount_charge": "0.00",
                        "amount_show": "0.00",
                        "commission_info": {
                          "show": {
                            "amount_gross": "0.00",
                            "amount_net": "0.00",
                            "amount_commission": "0.00"
                          },
                          "charge": {
                            "amount_gross": "0.00",
                            "amount_net": "0.00",
                            "amount_commission": "0.00"
                          }
                        }
                      },
                      {
                        "start_at": "2025-10-15T00:00:00",
                        "end_at": "2025-10-16T00:00:00",
                        "amount_charge": "252.91",
                        "amount_show": "295.00",
                        "commission_info": {
                          "show": {
                            "amount_gross": "327.78",
                            "amount_net": "295.00",
                            "amount_commission": "32.78"
                          },
                          "charge": {
                            "amount_gross": "281.02",
                            "amount_net": "252.92",
                            "amount_commission": "28.10"
                          }
                        }
                      },
                      {
                        "start_at": "2025-10-16T00:00:00",
                        "end_at": null,
                        "amount_charge": "505.83",
                        "amount_show": "590.00",
                        "commission_info": {
                          "show": {
                            "amount_gross": "655.56",
                            "amount_net": "590.00",
                            "amount_commission": "65.56"
                          },
                          "charge": {
                            "amount_gross": "562.04",
                            "amount_net": "505.84",
                            "amount_commission": "56.20"
                          }
                        }
                      }
                    ],
                    "free_cancellation_before": "2025-10-15T00:00:00"
                  },
                  "recommended_price": null
                }
              ]
            },
            "bar_rate_price_data": null,
            "rg_ext": {
              "class": 4,
              "quality": 0,
              "sex": 0,
              "bathroom": 1,
              "bedding": 1,
              "family": 0,
              "capacity": 2,
              "club": 0,
              "bedrooms": 0,
              "balcony": 0,
              "view": 0,
              "floor": 0
            },
            "room_name": "Junior Suite",
            "room_name_info": null,
            "serp_filters": [
              "has_breakfast",
              "has_bathroom"
            ],
            "sell_price_limits": null,
            "allotment": 2,
            "amenities_data": [
              "king-bed",
              "non-smoking"
            ],
            "any_residency": true,
            "deposit": null,
            "no_show": {
              "amount": "0.00",
              "currency_code": "USD",
              "from_time": "00:00:00"
            },
            "room_data_trans": {
              "main_room_type": "Junior Suite",
              "main_name": "Junior Suite",
              "bathroom": null,
              "bedding_type": null,
              "misc_room_type": null
            },
            "legal_info": null,
            "is_package": false
          },
          {
            "match_hash": "m-93e00476-3749-5d15-98f6-97ed061afd71",
            "search_hash": "sr-01998009-2889-7d7b-8022-75259a65fa10",
            "daily_prices": [
              "147.00",
              "147.00",
              "147.00",
              "147.00",
              "147.00"
            ],
            "meal": "breakfast-buffet",
            "meal_data": {
              "value": "breakfast-buffet",
              "has_breakfast": true,
              "no_child_meal": false
            },
            "payment_options": {
              "payment_types": [
                {
                  "amount": "630.15",
                  "show_amount": "735.00",
                  "currency_code": "EUR",
                  "show_currency_code": "USD",
                  "by": null,
                  "is_need_credit_card_data": false,
                  "is_need_cvc": false,
                  "type": "deposit",
                  "vat_data": {
                    "included": false,
                    "applied": false,
                    "amount": "0.00",
                    "currency_code": "USD",
                    "value": "0.00"
                  },
                  "tax_data": {
                    "taxes": [
                      {
                        "name": "city_tax",
                        "included_by_supplier": false,
                        "amount": "31.50",
                        "currency_code": "HNL"
                      },
                      {
                        "name": "occupancy_tax",
                        "included_by_supplier": false,
                        "amount": "25.20",
                        "currency_code": "HNL"
                      },
                      {
                        "name": "resort_fee",
                        "included_by_supplier": true,
                        "amount": "12.60",
                        "currency_code": "USD"
                      },
                      {
                        "name": "service_fee",
                        "included_by_supplier": true,
                        "amount": "63.01",
                        "currency_code": "USD"
                      }
                    ]
                  },
                  "perks": {},
                  "commission_info": {
                    "show": {
                      "amount_gross": "735.00",
                      "amount_net": "735.00",
                      "amount_commission": "0.00"
                    },
                    "charge": {
                      "amount_gross": "630.16",
                      "amount_net": "630.16",
                      "amount_commission": "0.00"
                    }
                  },
                  "cancellation_penalties": {
                    "policies": [
                      {
                        "start_at": null,
                        "end_at": null,
                        "amount_charge": "630.15",
                        "amount_show": "735.00",
                        "commission_info": {
                          "show": {
                            "amount_gross": "816.67",
                            "amount_net": "735.00",
                            "amount_commission": "81.67"
                          },
                          "charge": {
                            "amount_gross": "700.17",
                            "amount_net": "630.16",
                            "amount_commission": "70.02"
                          }
                        }
                      }
                    ],
                    "free_cancellation_before": null
                  },
                  "recommended_price": null
                }
              ]
            },
            "bar_rate_price_data": null,
            "rg_ext": {
              "class": 5,
              "quality": 0,
              "sex": 0,
              "bathroom": 1,
              "bedding": 1,
              "family": 0,
              "capacity": 2,
              "club": 0,
              "bedrooms": 0,
              "balcony": 0,
              "view": 0,
              "floor": 0
            },
            "room_name": "Suite",
            "room_name_info": null,
            "serp_filters": [
              "has_breakfast",
              "has_bathroom"
            ],
            "sell_price_limits": null,
            "allotment": 2,
            "amenities_data": [
              "king-bed",
              "non-smoking"
            ],
            "any_residency": true,
            "deposit": null,
            "no_show": {
              "amount": "0.00",
              "currency_code": "USD",
              "from_time": "00:00:00"
            },
            "room_data_trans": {
              "main_room_type": "Suite",
              "main_name": "Suite",
              "bathroom": null,
              "bedding_type": null,
              "misc_room_type": null
            },
            "legal_info": null,
            "is_package": false
          }
        ],
        "bar_price_data": null
      }
    ],
    "total_hotels": 2
  },
  "debug": {
    "api_endpoint": {
      "endpoint": "api/b2b/v3/search/serp/hotels",
      "is_active": true,
      "is_limited": true,
      "remaining": 149,
      "requests_number": 150,
      "reset": "2025-09-30T17:56:00",
      "seconds_number": 60
    },
    "request": {
      "checkin": "2025-10-17",
      "checkout": "2025-10-22",
      "residency": "gb",
      "language": "en",
      "guests": [
        {
          "adults": 2,
          "children": []
        }
      ],
      "hids": [
        10595223,
        10654204
      ],
      "currency": "USD"
    },
    "method": "POST",
    "real_ip": "104.30.161.77",
    "request_id": "f6fbd9919039a626ceeaadc055f6a120",
    "key_id": 5,
    "api_key_id": 5,
    "utcnow": "2025-09-30T17:55:10.608382"
  },
  "status": "ok",
  "error": null
}

Errors

Invalid JSON

The error field has the invalid_json_format value. The debug.validation_error field has the value specified in the headers below.

`body_must_be_json`

The passed JSON isn’t valid.

Invalid parameters or request body

For these, the error field has the invalid_params value. The debug.validation_error field has the value specified in the headers below.

`number of ids should be less than or equal to X`

The item number of the ids field must be between 1 and 300.

`date should be ISO8601 (YYYY-MM-DD)`

The passed checkin and checkout fields have an invalid format. The valid format is YYYY-MM-DD.

`checkin date must be current or future date`

The checkin field value is in the past. Provide the current or future date.

`checkin date must be less than or equal to 730 days since today`

The checkin field value should be no later than 730 days from the day of the request.

`checkout date must be less than or equal to %d days since today`

The checkout field value should be no later than 30 days from the checkin field value.

`checkout date must be after checkin date`

The checkout field value should be later than the checkin field value.

`checkout cannot be later than X days since checkin`

The checkout field value should be no later than 30 days from the checkin field value.

`residency is required`

The residency field is required.

`residency must be one of X`

The residency field has an invalid format. The valid format is in the ISO 3166-1 alpha-2.

`unknown currency`

The currency field has an invalid format. The valid format is in the ISO 4217.

`early checkin date must be equal checkin date`

The upsells.early_checkin.time field value should be the same as the checkin field value.

`late checkout date must be equal checkout date`

The upsells.late_checkout.time field value should be the same as the checkout field value.

`early checkin must be in datetime format`

The checkin field has an invalid format. The valid formats are:

2006-01-02.
2006-01-02 15:04.
2006-01-02T15:04.
2006-01-02 15:04:05.
2006-01-02T15:04:05.
2006-01-02T15:04:05-07:00.
2006-01-02T15:04:05Z07:00.

`late checkout must be in datetime format`

The checkout field has an invalid format. The valid formats are:

2006-01-02.
2006-01-02 15:04.
2006-01-02T15:04.
2006-01-02 15:04:05.
2006-01-02T15:04:05.
2006-01-02T15:04:05-07:00.
2006-01-02T15:04:05Z07:00.

`guests number must be positive`

The guests field value must be positive.

`too many rooms, value should be no more than X`

The item number of the guests field must be between 1 and 9.

`adults number per room must be in range 1 to X inc`

The adults field value must be between 1 and 6.

`children number per room must be not greater then X`

The children field value must be between 1 and 4.

`child's age must be in range 0 to X incl`

The age field value must be between 0 and 17.

Internal search error

⚠️

The error isn’t supported yet.

The error field has the сore_search_error value. The debug.validation_error field has the null value.

The error occurs if the ETG has an internal search error. The number of recurrent identical requests must be limited.