Get Hotel Content

Retrieve static hotel content, policies, facilities, photos, and room-type details for one hotel.

GET /hotels/{hotelId}/content

curl "$UNIFYSTAYS_BASE_URL/hotels/123456/content" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en"

200

{
  "success": true,
  "message": "Hotel content fetched successfully",
  "data": {
    "hotel_id": "10001",
    "hotel_name": "Taj Mahal Palace",
    "location": {
      "city": "Mumbai",
      "country": "India",
      "address": "123 Marine Drive",
      "state": "Maharashtra",
      "postal_code": "400001",
      "latitude": 18.9388,
      "longitude": 72.8354
    },
    "contact": {
      "phone": "[phone]",
      "email": "[e-mail]"
    },
    "hotel_type": "Hotel",
    "chain": "Taj Hotels",
    "stars": 5,
    "main_image_url": "https://cdn.example.com/taj-main.jpg",
    "markdown_description": {},
    "important_info": {},
    "checkin_policy": {
      "check_in_from": "14:00",
      "check_in_until": "23:00",
      "check_out_from": "07:00",
      "check_out_until": "12:00",
      "special_instructions": "Photo ID required at check-in.",
      "instructions": [
        "Front desk open 24 hours",
        "Late check-in: please call ahead"
      ]
    },
    "facilities": [
      "Swimming Pool",
      "Spa",
      "Restaurant",
      "Free Wi-Fi"
    ],
    "photos": [
      {
        "url": "https://cdn.example.com/lobby.jpg",
        "caption": "Lobby"
      }
    ],
    "policies": {},
    "city_id": 101
  }
}

Use this endpoint for a property detail page or any static hotel information needed around a booking flow. It returns content from the Unifystays local catalogue rather than making a supplier API call.

Request Example

curl "$UNIFYSTAYS_BASE_URL/hotels/123456/content" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en"

What It Contains

The response includes descriptive copy, location, contact information, check-in policy, facilities, photos, hotel-level policies, and the static room catalogue with amenities, bed types, and room photos.

Hotel content is static, non-pricing data and can be cached according to your product’s content-freshness policy. It does not guarantee a current price, room availability, or a bookable rate.

Use Get Room Options after the customer selects the hotel and stay details. Use this endpoint’s content to enrich the property page, not as a replacement for live availability.

The OpenAPI section below provides the complete hotel-content response schema.

Authorizations

x-api-key · string · header · required

Environment-specific API key created in the Unifystays portal

Headers

Path Parameters

hotelId · string · required

Internal hotel_id (bigint stored as string).

Example:

"10001"

Response

200

application/json

Hotel content returned successfully.

success · boolean · required

Example:

true

message · string · required

Example:

"Hotel content fetched successfully"

data · object · required

Show child attributes