Retrieve hotels content by IDs
https://api.worldota.net/api/content/v1/hotel_content_by_ids/
The call allow to obtain a required hotel content by id. Use the call in cases:
- Instead of hotel static data
- You want to check the content before making a booking with a possible update.
- Use this call after the Retrieve hotel IDs by filter call.
ℹ️
The limit is 100 IDs.
Request example
ℹ️
Only one of HIDs or IDs can be specified in the request.
curl --user '<KEY_ID>:<API_KEY>' 'https://api.worldota.net/api/content/v1/hotel_content_by_ids/' \
--header 'Content-Type: application/json' \
--data '{
"hids": [9852019],
"language": "en"
}'
curl --user '<KEY_ID>:<API_KEY>' 'https://api.worldota.net/api/content/v1/hotel_content_by_ids/' \
--header 'Content-Type: application/json' \
--data '{
"ids": ["hotel_1"],
"language": "en"
}'
Request body
Response
Response example
{
"data": [
{
"address": "Katiet Bosua,South Sipora,Mentawai, Katiet",
"amenity_groups": [
{
"amenities": [
"Smoke-free property",
"Terrace",
"All Spaces Non-Smoking (public and private)"
],
"non_free_amenities": null,
"group_name": "General"
},
{
"amenities": [
"Non-smoking rooms",
"Shower"
],
"non_free_amenities": null,
"group_name": "Rooms"
},
{
"amenities": [
"Bottled water"
],
"non_free_amenities": null,
"group_name": "Meals"
},
{
"amenities": [
"Internet"
],
"non_free_amenities": [
"Internet"
],
"group_name": "Internet"
},
{
"amenities": [
"Free parking"
],
"non_free_amenities": null,
"group_name": "Parking"
}
],
"check_in_time": "14:00:00",
"check_out_time": "12:00:00",
"description_struct": [
{
"paragraphs": [
"You’ll be sleeping tight! Hotel «Lances Right Villas Katiet» is located in Katiet. This hotel is located minutes away from the city center."
],
"title": "Location"
},
{
"paragraphs": [
"If you travel by car, you can park in a parking zone for free."
],
"title": "At the hotel"
},
{
"paragraphs": [
"In the room, for you, there is a shower. The room equipment depends on its category."
],
"title": "Room amenities"
}
],
"email": "",
"hotel_chain": "No chain",
"hid": 9852019,
"id": "lances_right_villas_katiet",
"images_ext": [],
"kind": "Hotel",
"latitude": -2.37579,
"longitude": 99.84819,
"name": "Lances Right Villas Katiet",
"metapolicy_struct": {
"add_fee": [],
"check_in_check_out": [],
"children": [],
"children_meal": [],
"cot": [],
"deposit": [],
"extra_bed": [],
"internet": [],
"meal": [],
"no_show": {
"availability": "unspecified",
"day_period": "unspecified",
"time": ""
},
"parking": [],
"pets": [],
"shuttle": [],
"visa": {
"visa_support": "unspecified"
}
},
"metapolicy_extra_info": "To prevent the spread of the Mpox virus, the Indonesian Ministry of Health has resumed health screening for international travelers (both Indonesian and foreign nationals) entering Indonesia from August 27, 2024. This includes completing an electronic self-declaration form called SATUSEHAT Health Pass, which must be completed on a dedicated web platform.\n<ul> <li>There is no hot water on site. </li> </ul>",
"phone": "62-08126626702",
"policy_struct": [
{
"paragraphs": [
"Information about the type of meals included in the price is indicated in the rate details.",
"Meals may be limited during Ramadan."
],
"title": "Meals"
},
{
"paragraphs": [
"Couples checking into the same room must present a valid marriage certificate upon check-in. Otherwise, the property may reject the booking or request that a second room be booked."
],
"title": "Special living conditions"
},
{
"paragraphs": [
"To prevent the spread of the Mpox virus, the Indonesian Ministry of Health has resumed health screening for international travelers (both Indonesian and foreign nationals) entering Indonesia from August 27, 2024. This includes completing an electronic self-declaration form called SATUSEHAT Health Pass, which must be completed on a dedicated web platform.",
"<ul> <li>There is no hot water on site. </li> </ul>"
],
"title": "Extra info"
}
],
"postal_code": "25972",
"region": {
"country_code": "ID",
"iata": "",
"id": 965851524,
"name": "Katiet",
"type": "City"
},
"room_groups": [],
"star_rating": 2,
"serp_filters": [
"has_parking"
],
"star_certificate": {
"valid_to": "",
"certificate_id": ""
},
"is_closed": false,
"facts": {
"electricity": {
"frequency": [
50
],
"voltage": [
230
],
"sockets": [
"c",
"f"
]
},
"kind": "",
"star_rating": 0,
"type": "",
"floors_number": 0,
"rooms_number": 0,
"year_built": 0,
"year_renovated": 0,
"register": {
"record": "",
"link": "",
"email": "",
"phone": "",
"status": "",
"fsa_kind": "unspecified",
"fsa_name": "",
"address": "",
"rooms": []
}
},
"payment_methods": null,
"front_desk_time_start": "",
"front_desk_time_end": "",
"is_gender_specification_required": false,
"deleted": false,
"keys_pickup": {
"type": "unspecified",
"phone": "",
"is_contactless": false,
"email": "",
"apartment_office_address": "",
"apartment_extra_information": ""
}
}
],
"debug": {
"api_endpoint": {
"endpoint": "",
"is_active": false,
"is_limited": false,
"remaining": 0,
"requests_number": 0,
"reset": "",
"seconds_number": 0
},
"request": {
"hids": [
9852019
],
"language": "en"
},
"method": "",
"real_ip": "",
"request_id": "",
"key_id": 1234,
"api_key_id": 0,
"utcnow": ""
},
"status": "ok",
"error": null
}
Errors
The error
field has the value specified in the headers below.
invalid_params
One or more input parameters are incorrect. For more details, see the response field debug validation_error.
no_content
An internal search error. Has 500
status code.