ETG API V3
Content API
Retrieve hotels content by IDs

Retrieve hotels content by IDs

#content-api

https://api-sandbox.worldota.net/api/content/v1/hotel_content_by_ids/
https://api.worldota.net/api/content/v1/hotel_content_by_ids/
⚠️
Do not call this endpoint during live user search sessions or when displaying hotel lists. This endpoint is intended exclusively for scheduled, offline content synchronization. Real-time usage during user interactions may lead to service degradation and is not allowed.

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.
  • Scheduled daily or weekly synchronization of hotel content to keep your local database up-to-date.
  • On-demand refresh of hotel content for a specific property before making a reservation (similar to the /hotel/info/ endpoint usage).
ℹ️
  • Call is limited to 1200 requests per minute (QPM).
  • Maximum 100 hotel IDs per request.

Sandbox limitations

⚠️
Use only field values, IDs, API keys, and any static content from the sandbox environment within the sandbox. Do not use sandbox data in test or production environments, and do not mix data or configuration between different environments.

Request example 

curl --user '<KEY_ID>:<API_KEY>' 'https://api-sandbox.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 '{
  "hids": [9852019],
  "language": "en"
}'

Request body

Response

Response example 

{
 "data": [
   {
     "address": "Katiet Bosua, South Sipora, Mentawai, Bosua, Mentawai Islands Regency, West Sumatra, Indonesia, Katiet",
     "amenity_groups": [],
     "check_in_time": "14:00:00",
     "check_in_time_end": "",
     "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"
       }
     ],
     "email": "",
     "hotel_chain": "No chain",
     "hid": 9852019,
     "id": "lances_right_villas_katiet",
     "images_ext": [],
     "kind": "Hotel",
     "latitude": -2.3758,
     "longitude": 99.8482,
     "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": null,
     "star_certificate": {
       "valid_to": "",
       "certificate_id": ""
     },
     "is_closed": false,
     "facts": {
       "electricity": {
         "frequency": [
           50
         ],
         "voltage": [
           230
         ],
         "sockets": [
           "c",
           "f"
         ]
       },
       "type": "",
       "floors_number": 0,
       "rooms_number": 0,
       "year_built": 0,
       "year_renovated": 0,
       "register": {
         "record": "",
         "link": "",
         "email": "",
         "phone": "",
         "status": "",
         "kind": "unspecified",
         "name": "",
         "address": "",
         "status_end_date": "",
         "rooms": [],
         "taxpayer_number": "",
         "state_registration_number": "",
         "work_time": "from 9-18 local time"
       }
     },
     "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": ""
     },
     "distance_center": 975,
     "giata_code": "1087889"
   }
 ],
 "debug": {
   "api_endpoint": {
     "endpoint": "api/content/v1/hotel_content_by_ids",
     "is_active": true,
     "is_limited": true,
     "remaining": 99999,
     "requests_number": 100000,
     "reset": "2026-06-10T22:36:00",
     "seconds_number": 60
   },
   "request": {
     "hids": [
       9852019
     ],
     "language": "en"
   },
   "method": "POST",
   "real_ip": "104.30.161.77",
   "request_id": "f6caee9df14c4ea0cba4038bc3b0143e",
   "key_id": 1234,
   "api_key_id": 1234,
   "utcnow": "2026-06-10T22:35:57.874094"
 },
 "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.