Region Search Engine Results Page
https://api.worldota.net/api/b2b/v3/search/serp/region/
The call gets hotels’ rates by the SERP mechanism and the given region.
- Let users choose the rates from this call response isn’t recommended.
- A full match with a response from the Hotelpage request isn’t expected.
Request example
curl --user '<KEY_ID>:<API_KEY>' 'https://api.worldota.net/api/b2b/v3/search/serp/region/' \
--header 'Content-Type: application/json' \
--data '{
"checkin": "2025-10-22",
"checkout": "2025-10-25",
"residency": "gb",
"language": "en",
"guests": [
{
"adults": 2,
"children": []
}
],
"region_id": 965849721,
"currency": "EUR"
}'
Request body
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.
The hotel data language.
- The default value is the contract language.
- The possible values:
ar
—Arabic.bg
–Bulgarian.cs
–Czech.de
–German.el
–Greek.en
–English.es
–Spanish.fr
–French.he
–Hebrew.hu
–Hungarian.it
–Italian.ja
–Japanese.kk
–Kazakh.ko
–Korean.nl
–Dutch.pl
–Polish.pt
–Portuguese.pt_PT
–Portuguese (Portugal).ro
–Romanian.ru
–Russian.sq
–Albanian.sr
–Serbian.th
–Thai.tr
–Turkish.uk
–Ukrainian.vi
–Vietnamese.zh_CN
–Simplified Chinese.
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 maximum amount of time in seconds within which searching for rates will be executed.
- The maximum value is
100
.
The list of guests in the rooms.
In case of a multiroom search, for each room equal pax numbers are highly recommended for usage. If different pax numbers are required, we recommend that you make a separate request for each room.
- One list item represents one room.
- The maximum number of rooms per request is
9
.
The number of adult guests in one room.
- The minimum value is
1
. - The maximum value is
6
.
Response
The list of hotels and their rates.
The most preferred hotel ID.
- Either this field or the
id
field is required. - The maximum length is
7
characters.
The list of available hotel rates.
The room amenities list.
To get all available room amenities and their definitions, use the room_amenities
field from the Hotel Static Data call.
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.
The unique rate ID used to identify the selected rate.
- Use this value in the
book_hash
field of the Order Booking Form call. - The value lifetime is 6 hours after you have got the rate from the search results.
The deposit information of the order. Has a value if the rate payment_types.type
field has the hotel
value.
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.
The meal type in the rate.
To get all available meal types and their definitions, use the meals
field from the Hotel Static Data call.
Has the nomeal
value if no meal type is provided.
The rate meals information.
The meal type in the rate.
To get all available meal types and their definitions, use the meals
field from the Hotel Static Data call.
Has the nomeal
value if no meal type is provided.
The no-show penalty information.
The accepted payment options with the specified amount to be charged.
For a booking, this amount in the requested currency should be paid.
The list with accepted payment options.
The cancellation rules and commission information.
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.
The cancellation policies breakdown by periods.
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.
The tax information.
The taxes list.
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
.
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.
The ETG tax ID.
To get all available tax IDs and their definitions, use the taxes
filed from the Hotel Static Data call.
The hotel room type.
Use this field to get extra data on the room from the hotel static data. For example, room images, descriptions.
The room bathroom information.
The possible values:
0
—undefined.1
—a shared bathroom.2
—a private bathroom.3
—an external private bathroom.
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.
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.
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.
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.
Whether it is a club room or not.
The possible values:
0
—not a club room.1
—a club room.
Whether it is a family room or not.
The possible values:
0
—not a family room.1
—a family room.
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.
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.
The room gender restrictions.
The possible values:
0
—undefined.1
—male.2
—female.3
—mixed.
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.
The room information in the request language.
The hotel and service provider legal information.
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.
Response example
{
"data": {
"hotels": [
{
"id": "rila_muam_castle_hotel",
"hid": 9025546,
"rates": [
{
"match_hash": "m-e5bd52dd-670c-5fb8-9be0-dc7e1d36be12",
"search_hash": "sr-0193a945-92bb-7190-8455-28cc350f6e9f",
"daily_prices": [
"24.00",
"24.00",
"24.00"
],
"meal": "nomeal",
"meal_data": {
"value": "nomeal",
"has_breakfast": false,
"no_child_meal": true
},
"payment_options": {
"payment_types": [
{
"amount": "76.20",
"show_amount": "72.00",
"currency_code": "EUR",
"show_currency_code": "EUR",
"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": {},
"perks": {},
"commission_info": {
"show": {
"amount_gross": "90.00",
"amount_net": "72.00",
"amount_commission": "18.00"
},
"charge": {
"amount_gross": "9514.00",
"amount_net": "7611.20",
"amount_commission": "1902.80"
}
},
"cancellation_penalties": {
"policies": [
{
"start_at": null,
"end_at": "2025-10-19T18:30: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-19T18:30:00",
"end_at": null,
"amount_charge": "7611.20",
"amount_show": "72.00",
"commission_info": {
"show": {
"amount_gross": "90.00",
"amount_net": "72.00",
"amount_commission": "18.00"
},
"charge": {
"amount_gross": "9514.00",
"amount_net": "7611.20",
"amount_commission": "1902.80"
}
}
}
],
"free_cancellation_before": "2025-10-19T18:30:00"
},
"recommended_price": null
}
]
},
"bar_rate_price_data": null,
"rg_ext": {
"class": 3,
"quality": 2,
"sex": 0,
"bathroom": 2,
"bedding": 3,
"family": 0,
"capacity": 2,
"club": 0,
"bedrooms": 0,
"balcony": 0,
"view": 0,
"floor": 0
},
"legal_info": null,
"room_name": "Standard Double room (full double bed)",
"room_name_info": {
"original_rate_name": "Basic Room 1 Double Bed Non Smoking 1 Double Bed"
},
"serp_filters": [
"has_bathroom"
],
"sell_price_limits": null,
"allotment": 1,
"amenities_data": [
"non-smoking"
],
"any_residency": false,
"deposit": null,
"no_show": null,
"room_data_trans": {
"main_room_type": "Standard Double room",
"main_name": "Standard Double room",
"bathroom": null,
"bedding_type": "full double bed",
"misc_room_type": null
}
},
{
"match_hash": "m-0afed42a-c8b9-5287-811b-fa29f24813ad",
"search_hash": "sr-0193a945-92bb-7191-917f-b591fa84d38e",
"daily_prices": [
"24.27",
"24.27",
"24.27"
],
"meal": "nomeal",
"meal_data": {
"value": "nomeal",
"has_breakfast": false,
"no_child_meal": true
},
"payment_options": {
"payment_types": [
{
"amount": "77.20",
"show_amount": "72.80",
"currency_code": "EUR",
"show_currency_code": "EUR",
"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": {},
"perks": {},
"commission_info": {
"show": {
"amount_gross": "91.00",
"amount_net": "72.80",
"amount_commission": "18.20"
},
"charge": {
"amount_gross": "9629.00",
"amount_net": "7703.20",
"amount_commission": "1925.80"
}
},
"cancellation_penalties": {
"policies": [
{
"start_at": null,
"end_at": "2025-10-20T23: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-20T23:00:00",
"end_at": null,
"amount_charge": "7703.20",
"amount_show": "72.80",
"commission_info": {
"show": {
"amount_gross": "91.00",
"amount_net": "72.80",
"amount_commission": "18.20"
},
"charge": {
"amount_gross": "9629.00",
"amount_net": "7703.20",
"amount_commission": "1925.80"
}
}
}
],
"free_cancellation_before": "2025-10-20T23:00:00"
},
"recommended_price": null
}
]
},
"bar_rate_price_data": null,
"rg_ext": {
"class": 3,
"quality": 2,
"sex": 0,
"bathroom": 2,
"bedding": 3,
"family": 0,
"capacity": 2,
"club": 0,
"bedrooms": 0,
"balcony": 0,
"view": 0,
"floor": 0
},
"legal_info": null,
"room_name": "Standard Double room (full double bed)",
"room_name_info": {
"original_rate_name": "Basic Room, 1 Double Bed, Non Smoking 1 Double Bed"
},
"serp_filters": [
"has_bathroom"
],
"sell_price_limits": null,
"allotment": 1,
"amenities_data": [
"non-smoking"
],
"any_residency": false,
"deposit": null,
"no_show": null,
"room_data_trans": {
"main_room_type": "Standard Double room",
"main_name": "Standard Double room",
"bathroom": null,
"bedding_type": "full double bed",
"misc_room_type": null
}
},
{
"match_hash": "m-d11cabbe-804e-5fb9-ba76-5eddd2a024e5",
"search_hash": "sr-0193a945-92bb-7199-89f4-7e409ca1f3b1",
"daily_prices": [
"27.20",
"27.20",
"27.20"
],
"meal": "nomeal",
"meal_data": {
"value": "nomeal",
"has_breakfast": false,
"no_child_meal": true
},
"payment_options": {
"payment_types": [
{
"amount": "86.80",
"show_amount": "81.60",
"currency_code": "EUR",
"show_currency_code": "EUR",
"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": {},
"perks": {},
"commission_info": {
"show": {
"amount_gross": "102.00",
"amount_net": "81.60",
"amount_commission": "20.40"
},
"charge": {
"amount_gross": "10761.00",
"amount_net": "8608.80",
"amount_commission": "2152.20"
}
},
"cancellation_penalties": {
"policies": [
{
"start_at": null,
"end_at": "2025-10-20T23: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-20T23:00:00",
"end_at": null,
"amount_charge": "8608.80",
"amount_show": "81.60",
"commission_info": {
"show": {
"amount_gross": "102.00",
"amount_net": "81.60",
"amount_commission": "20.40"
},
"charge": {
"amount_gross": "10761.00",
"amount_net": "8608.80",
"amount_commission": "2152.20"
}
}
}
],
"free_cancellation_before": "2025-10-20T23:00:00"
},
"recommended_price": null
}
]
},
"bar_rate_price_data": null,
"rg_ext": {
"class": 3,
"quality": 18,
"sex": 0,
"bathroom": 2,
"bedding": 3,
"family": 0,
"capacity": 2,
"club": 0,
"bedrooms": 0,
"balcony": 0,
"view": 0,
"floor": 0
},
"legal_info": null,
"room_name": "Classic Double room (full double bed)",
"room_name_info": {
"original_rate_name": "Classic Room, 1 Double Bed, Non Smoking 1 Double Bed"
},
"serp_filters": [
"has_bathroom"
],
"sell_price_limits": null,
"allotment": 1,
"amenities_data": [
"non-smoking"
],
"any_residency": false,
"deposit": null,
"no_show": null,
"room_data_trans": {
"main_room_type": "Classic Double room",
"main_name": "Classic Double room",
"bathroom": null,
"bedding_type": "full double bed",
"misc_room_type": null
}
},
{
"match_hash": "m-a2f47d9c-4cff-5599-b0cf-cbc41a600217",
"search_hash": "sr-0193a945-92bb-7193-83b9-6ecf2bc65a51",
"daily_prices": [
"27.73",
"27.73",
"27.73"
],
"meal": "nomeal",
"meal_data": {
"value": "nomeal",
"has_breakfast": false,
"no_child_meal": true
},
"payment_options": {
"payment_types": [
{
"amount": "87.00",
"show_amount": "83.20",
"currency_code": "EUR",
"show_currency_code": "EUR",
"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": "EUR",
"value": "0.00"
},
"tax_data": {},
"perks": {},
"commission_info": {
"show": {
"amount_gross": "104.00",
"amount_net": "83.20",
"amount_commission": "20.80"
},
"charge": {
"amount_gross": "10920.00",
"amount_net": "8736.00",
"amount_commission": "2184.00"
}
},
"cancellation_penalties": {
"policies": [
{
"start_at": null,
"end_at": "2025-10-21T02: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-21T02:00:00",
"end_at": null,
"amount_charge": "8736.00",
"amount_show": "83.20",
"commission_info": {
"show": {
"amount_gross": "104.00",
"amount_net": "83.20",
"amount_commission": "20.80"
},
"charge": {
"amount_gross": "10920.00",
"amount_net": "8736.00",
"amount_commission": "2184.00"
}
}
}
],
"free_cancellation_before": "2025-10-21T02:00:00"
},
"recommended_price": null
}
]
},
"bar_rate_price_data": null,
"rg_ext": {
"class": 3,
"quality": 1,
"sex": 0,
"bathroom": 2,
"bedding": 3,
"family": 0,
"capacity": 2,
"club": 0,
"bedrooms": 0,
"balcony": 0,
"view": 0,
"floor": 0
},
"legal_info": null,
"room_name": "Economy Double room (full double bed)",
"room_name_info": {
"original_rate_name": "Double room - Budget"
},
"serp_filters": [
"has_bathroom"
],
"sell_price_limits": null,
"allotment": 10,
"amenities_data": [
"non-smoking"
],
"any_residency": false,
"deposit": null,
"no_show": null,
"room_data_trans": {
"main_room_type": "Economy Double room",
"main_name": "Economy Double room",
"bathroom": null,
"bedding_type": "full double bed",
"misc_room_type": null
}
},
{
"match_hash": "m-11f24bac-a8d4-5105-a18b-a9e3612b9eb0",
"search_hash": "sr-0193a945-92bb-7195-aeed-6d32ff757335",
"daily_prices": [
"30.93",
"30.93",
"30.93"
],
"meal": "nomeal",
"meal_data": {
"value": "nomeal",
"has_breakfast": false,
"no_child_meal": true
},
"payment_options": {
"payment_types": [
{
"amount": "97.60",
"show_amount": "92.80",
"currency_code": "EUR",
"show_currency_code": "EUR",
"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": "EUR",
"value": "0.00"
},
"tax_data": {},
"perks": {},
"commission_info": {
"show": {
"amount_gross": "116.00",
"amount_net": "92.80",
"amount_commission": "23.20"
},
"charge": {
"amount_gross": "12247.00",
"amount_net": "9797.60",
"amount_commission": "2449.40"
}
},
"cancellation_penalties": {
"policies": [
{
"start_at": null,
"end_at": "2025-10-21T02: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-21T02:00:00",
"end_at": null,
"amount_charge": "9797.60",
"amount_show": "92.80",
"commission_info": {
"show": {
"amount_gross": "116.00",
"amount_net": "92.80",
"amount_commission": "23.20"
},
"charge": {
"amount_gross": "12247.00",
"amount_net": "9797.60",
"amount_commission": "2449.40"
}
}
}
],
"free_cancellation_before": "2025-10-21T02:00:00"
},
"recommended_price": null
}
]
},
"bar_rate_price_data": null,
"rg_ext": {
"class": 3,
"quality": 18,
"sex": 0,
"bathroom": 2,
"bedding": 3,
"family": 0,
"capacity": 2,
"club": 0,
"bedrooms": 0,
"balcony": 0,
"view": 0,
"floor": 0
},
"legal_info": null,
"room_name": "Classic Double room (full double bed)",
"room_name_info": {
"original_rate_name": "Double room - Classic"
},
"serp_filters": [
"has_bathroom"
],
"sell_price_limits": null,
"allotment": 10,
"amenities_data": [
"non-smoking"
],
"any_residency": false,
"deposit": null,
"no_show": null,
"room_data_trans": {
"main_room_type": "Classic Double room",
"main_name": "Classic Double room",
"bathroom": null,
"bedding_type": "full double bed",
"misc_room_type": null
}
},
{
"match_hash": "m-3cb9eb4a-4ad9-5208-bd20-571f77894158",
"search_hash": "sr-0193a945-92bb-7196-812d-f61f80742d9e",
"daily_prices": [
"32.53",
"32.53",
"32.53"
],
"meal": "nomeal",
"meal_data": {
"value": "nomeal",
"has_breakfast": false,
"no_child_meal": true
},
"payment_options": {
"payment_types": [
{
"amount": "102.60",
"show_amount": "97.60",
"currency_code": "EUR",
"show_currency_code": "EUR",
"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": {},
"perks": {},
"commission_info": {
"show": {
"amount_gross": "122.00",
"amount_net": "97.60",
"amount_commission": "24.40"
},
"charge": {
"amount_gross": "12867.00",
"amount_net": "10293.60",
"amount_commission": "2573.40"
}
},
"cancellation_penalties": {
"policies": [
{
"start_at": null,
"end_at": "2025-10-19T18:30: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-19T18:30:00",
"end_at": null,
"amount_charge": "10293.60",
"amount_show": "97.60",
"commission_info": {
"show": {
"amount_gross": "122.00",
"amount_net": "97.60",
"amount_commission": "24.40"
},
"charge": {
"amount_gross": "12867.00",
"amount_net": "10293.60",
"amount_commission": "2573.40"
}
}
}
],
"free_cancellation_before": "2025-10-19T18:30:00"
},
"recommended_price": null
}
]
},
"bar_rate_price_data": null,
"rg_ext": {
"class": 3,
"quality": 2,
"sex": 0,
"bathroom": 2,
"bedding": 3,
"family": 0,
"capacity": 2,
"club": 0,
"bedrooms": 0,
"balcony": 0,
"view": 0,
"floor": 0
},
"legal_info": null,
"room_name": "Standard Double room (full double bed) (queen size bed)",
"room_name_info": {
"original_rate_name": "Standard Room 1 Queen Bed"
},
"serp_filters": [
"has_bathroom"
],
"sell_price_limits": null,
"allotment": 1,
"amenities_data": [
"queen-bed",
"non-smoking"
],
"any_residency": false,
"deposit": null,
"no_show": null,
"room_data_trans": {
"main_room_type": "Standard Double room",
"main_name": "Standard Double room",
"bathroom": null,
"bedding_type": "full double bed",
"misc_room_type": "queen size bed"
}
},
{
"match_hash": "m-ab58b911-377f-5e92-880e-b6816a1dcb91",
"search_hash": "sr-0193a945-92bb-7197-a384-3b699f04d2e7",
"daily_prices": [
"33.07",
"33.07",
"33.07"
],
"meal": "nomeal",
"meal_data": {
"value": "nomeal",
"has_breakfast": false,
"no_child_meal": true
},
"payment_options": {
"payment_types": [
{
"amount": "104.80",
"show_amount": "99.20",
"currency_code": "EUR",
"show_currency_code": "EUR",
"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": {},
"perks": {},
"commission_info": {
"show": {
"amount_gross": "124.00",
"amount_net": "99.20",
"amount_commission": "24.80"
},
"charge": {
"amount_gross": "13031.00",
"amount_net": "10424.80",
"amount_commission": "2606.20"
}
},
"cancellation_penalties": {
"policies": [
{
"start_at": null,
"end_at": "2025-10-20T23: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-20T23:00:00",
"end_at": null,
"amount_charge": "10424.80",
"amount_show": "99.20",
"commission_info": {
"show": {
"amount_gross": "124.00",
"amount_net": "99.20",
"amount_commission": "24.80"
},
"charge": {
"amount_gross": "13031.00",
"amount_net": "10424.80",
"amount_commission": "2606.20"
}
}
}
],
"free_cancellation_before": "2025-10-20T23:00:00"
},
"recommended_price": null
}
]
},
"bar_rate_price_data": null,
"rg_ext": {
"class": 3,
"quality": 2,
"sex": 0,
"bathroom": 2,
"bedding": 3,
"family": 0,
"capacity": 2,
"club": 0,
"bedrooms": 0,
"balcony": 0,
"view": 0,
"floor": 0
},
"legal_info": null,
"room_name": "Standard Double room (full double bed) (queen size bed)",
"room_name_info": {
"original_rate_name": "Standard Room 1 Queen Bed"
},
"serp_filters": [
"has_bathroom"
],
"sell_price_limits": null,
"allotment": 1,
"amenities_data": [
"non-smoking",
"queen-bed"
],
"any_residency": false,
"deposit": null,
"no_show": null,
"room_data_trans": {
"main_room_type": "Standard Double room",
"main_name": "Standard Double room",
"bathroom": null,
"bedding_type": "full double bed",
"misc_room_type": "queen size bed"
}
},
{
"match_hash": "m-a698ef29-aacf-5ff9-9792-dc73ec17efec",
"search_hash": "sr-0193a945-92bb-719a-bb95-7c443effd5bd",
"daily_prices": [
"38.13",
"38.13",
"38.13"
],
"meal": "nomeal",
"meal_data": {
"value": "nomeal",
"has_breakfast": false,
"no_child_meal": true
},
"payment_options": {
"payment_types": [
{
"amount": "120.60",
"show_amount": "114.40",
"currency_code": "EUR",
"show_currency_code": "EUR",
"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": {},
"perks": {},
"commission_info": {
"show": {
"amount_gross": "143.00",
"amount_net": "114.40",
"amount_commission": "28.60"
},
"charge": {
"amount_gross": "15092.00",
"amount_net": "12073.60",
"amount_commission": "3018.40"
}
},
"cancellation_penalties": {
"policies": [
{
"start_at": null,
"end_at": "2025-10-19T18:30: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-19T18:30:00",
"end_at": null,
"amount_charge": "12073.60",
"amount_show": "114.40",
"commission_info": {
"show": {
"amount_gross": "143.00",
"amount_net": "114.40",
"amount_commission": "28.60"
},
"charge": {
"amount_gross": "15092.00",
"amount_net": "12073.60",
"amount_commission": "3018.40"
}
}
}
],
"free_cancellation_before": "2025-10-19T18:30:00"
},
"recommended_price": null
}
]
},
"bar_rate_price_data": null,
"rg_ext": {
"class": 3,
"quality": 4,
"sex": 0,
"bathroom": 2,
"bedding": 3,
"family": 0,
"capacity": 2,
"club": 0,
"bedrooms": 0,
"balcony": 0,
"view": 0,
"floor": 0
},
"legal_info": null,
"room_name": "Business Double room (full double bed) (queen size bed)",
"room_name_info": {
"original_rate_name": "Business Room 1 Queen Bed"
},
"serp_filters": [
"has_bathroom"
],
"sell_price_limits": null,
"allotment": 1,
"amenities_data": [
"non-smoking",
"queen-bed"
],
"any_residency": false,
"deposit": null,
"no_show": null,
"room_data_trans": {
"main_room_type": "Business Double room",
"main_name": "Business Double room",
"bathroom": null,
"bedding_type": "full double bed",
"misc_room_type": "queen size bed"
}
},
{
"match_hash": "m-7df0bee8-31dc-5314-9e98-235e82761146",
"search_hash": "sr-0193a945-92bb-7192-bb30-0047bfdb8f2b",
"daily_prices": [
"38.67",
"38.67",
"38.67"
],
"meal": "nomeal",
"meal_data": {
"value": "nomeal",
"has_breakfast": false,
"no_child_meal": true
},
"payment_options": {
"payment_types": [
{
"amount": "122.00",
"show_amount": "116.00",
"currency_code": "EUR",
"show_currency_code": "EUR",
"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": {},
"perks": {},
"commission_info": {
"show": {
"amount_gross": "145.00",
"amount_net": "116.00",
"amount_commission": "29.00"
},
"charge": {
"amount_gross": "15295.00",
"amount_net": "12236.00",
"amount_commission": "3059.00"
}
},
"cancellation_penalties": {
"policies": [
{
"start_at": null,
"end_at": "2025-10-20T23: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-20T23:00:00",
"end_at": null,
"amount_charge": "12236.00",
"amount_show": "116.00",
"commission_info": {
"show": {
"amount_gross": "145.00",
"amount_net": "116.00",
"amount_commission": "29.00"
},
"charge": {
"amount_gross": "15295.00",
"amount_net": "12236.00",
"amount_commission": "3059.00"
}
}
}
],
"free_cancellation_before": "2025-10-20T23:00:00"
},
"recommended_price": null
}
]
},
"bar_rate_price_data": null,
"rg_ext": {
"class": 3,
"quality": 4,
"sex": 0,
"bathroom": 2,
"bedding": 3,
"family": 0,
"capacity": 2,
"club": 0,
"bedrooms": 0,
"balcony": 0,
"view": 0,
"floor": 0
},
"legal_info": null,
"room_name": "Business Double room (full double bed) (queen size bed)",
"room_name_info": {
"original_rate_name": "Business Room 1 Queen Bed"
},
"serp_filters": [
"has_bathroom"
],
"sell_price_limits": null,
"allotment": 1,
"amenities_data": [
"queen-bed",
"non-smoking"
],
"any_residency": false,
"deposit": null,
"no_show": null,
"room_data_trans": {
"main_room_type": "Business Double room",
"main_name": "Business Double room",
"bathroom": null,
"bedding_type": "full double bed",
"misc_room_type": "queen size bed"
}
},
{
"match_hash": "m-bbbbe085-6358-55a4-bb29-85c412c31210",
"search_hash": "sr-0193a945-92bb-7194-b1a8-47e471eb8dee",
"daily_prices": [
"50.67",
"50.67",
"50.67"
],
"meal": "nomeal",
"meal_data": {
"value": "nomeal",
"has_breakfast": false,
"no_child_meal": true
},
"payment_options": {
"payment_types": [
{
"amount": "160.80",
"show_amount": "152.00",
"currency_code": "EUR",
"show_currency_code": "EUR",
"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": {},
"perks": {},
"commission_info": {
"show": {
"amount_gross": "190.00",
"amount_net": "152.00",
"amount_commission": "38.00"
},
"charge": {
"amount_gross": "20101.00",
"amount_net": "16080.80",
"amount_commission": "4020.20"
}
},
"cancellation_penalties": {
"policies": [
{
"start_at": null,
"end_at": "2025-10-19T18:30: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-19T18:30:00",
"end_at": null,
"amount_charge": "16080.80",
"amount_show": "152.00",
"commission_info": {
"show": {
"amount_gross": "190.00",
"amount_net": "152.00",
"amount_commission": "38.00"
},
"charge": {
"amount_gross": "20101.00",
"amount_net": "16080.80",
"amount_commission": "4020.20"
}
}
}
],
"free_cancellation_before": "2025-10-19T18:30:00"
},
"recommended_price": null
}
]
},
"bar_rate_price_data": null,
"rg_ext": {
"class": 3,
"quality": 17,
"sex": 0,
"bathroom": 2,
"bedding": 3,
"family": 0,
"capacity": 2,
"club": 0,
"bedrooms": 0,
"balcony": 0,
"view": 0,
"floor": 0
},
"legal_info": null,
"room_name": "Premium Double room (full double bed) (queen size bed)",
"room_name_info": {
"original_rate_name": "Premium Room 1 Queen Bed"
},
"serp_filters": [
"has_bathroom"
],
"sell_price_limits": null,
"allotment": 1,
"amenities_data": [
"non-smoking",
"queen-bed"
],
"any_residency": false,
"deposit": null,
"no_show": null,
"room_data_trans": {
"main_room_type": "Premium Double room",
"main_name": "Premium Double room",
"bathroom": null,
"bedding_type": "full double bed",
"misc_room_type": "queen size bed"
}
},
{
"match_hash": "m-2e2f8702-b519-5d27-8d3a-125ac12d5a09",
"search_hash": "sr-0193a945-92bb-7198-af7c-8dd5f8f3a5ee",
"daily_prices": [
"51.47",
"51.47",
"51.47"
],
"meal": "nomeal",
"meal_data": {
"value": "nomeal",
"has_breakfast": false,
"no_child_meal": true
},
"payment_options": {
"payment_types": [
{
"amount": "163.00",
"show_amount": "154.40",
"currency_code": "EUR",
"show_currency_code": "EUR",
"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": {},
"perks": {},
"commission_info": {
"show": {
"amount_gross": "193.00",
"amount_net": "154.40",
"amount_commission": "38.60"
},
"charge": {
"amount_gross": "20390.00",
"amount_net": "16312.00",
"amount_commission": "4078.00"
}
},
"cancellation_penalties": {
"policies": [
{
"start_at": null,
"end_at": "2025-10-20T23: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-20T23:00:00",
"end_at": null,
"amount_charge": "16312.00",
"amount_show": "154.40",
"commission_info": {
"show": {
"amount_gross": "193.00",
"amount_net": "154.40",
"amount_commission": "38.60"
},
"charge": {
"amount_gross": "20390.00",
"amount_net": "16312.00",
"amount_commission": "4078.00"
}
}
}
],
"free_cancellation_before": "2025-10-20T23:00:00"
},
"recommended_price": null
}
]
},
"bar_rate_price_data": null,
"rg_ext": {
"class": 3,
"quality": 17,
"sex": 0,
"bathroom": 2,
"bedding": 3,
"family": 0,
"capacity": 2,
"club": 0,
"bedrooms": 0,
"balcony": 0,
"view": 0,
"floor": 0
},
"legal_info": null,
"room_name": "Premium Double room (full double bed) (queen size bed)",
"room_name_info": {
"original_rate_name": "Premium Room 1 Queen Bed"
},
"serp_filters": [
"has_bathroom"
],
"sell_price_limits": null,
"allotment": 1,
"amenities_data": [
"non-smoking",
"queen-bed"
],
"any_residency": false,
"deposit": null,
"no_show": null,
"room_data_trans": {
"main_room_type": "Premium Double room",
"main_name": "Premium Double room",
"bathroom": null,
"bedding_type": "full double bed",
"misc_room_type": "queen size bed"
}
}
],
"bar_price_data": null
}
],
"total_hotels": 1
},
"debug": {
"request": {
"checkin": "2025-10-22",
"checkout": "2025-10-25",
"residency": "gb",
"language": "en",
"guests": [
{
"adults": 2,
"children": []
}
],
"region_id": 965849721,
"currency": "EUR"
},
"key_id": 1234,
"validation_error": null
},
"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.
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
.
region_id value should be greater than 0
The region_id
field value is invalid. The valid value is equal to or greater than 0
.
hotels_limit value should be greater than or equal to 0
The hotels_limit
field value is invalid. The valid value is equal to or greater than 0
.
invalid region_id field, this region cannot be searched
The region_id
field value is invalid. The valid values are in the Hotel Region Dump call response.
Internal search error
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.
- A region search error.
The number of recurrent identical requests must be limited.