Get Hotel Content

curl "$UNIFYSTAYS_BASE_URL/hotels/10001/content" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY"

{
  "success": true,
  "message": "Hotel content fetched successfully",
  "data": {
    "hotel_id": "1001",
    "hotel_name": "Example Hotel",
    "hotel_type": "Hotel",
    "chain": "Example Chain",
    "stars": 4,
    "main_image_url": "https://example.test/main.jpg",
    "markdown_description": "**Stay** by the beach",
    "important_info": "Line one\nLine two",
    "location": {
      "address": "123 Main Street",
      "address_local": null,
      "state": "Goa",
      "country": "IN",
      "postal_code": "403001",
      "latitude": 15.49,
      "longitude": 73.82
    },
    "contact": { "phone": "+91-1111", "email": "stay@example.test" },
    "checkin_policy": {
      "check_in_from": "14:00:00",
      "check_in_until": "24:00:00",
      "check_out_from": null,
      "check_out_until": "11:00:00",
      "special_instructions": "Front desk closes at 22:00",
      "instructions": ["Photo ID required", "Credit card required"]
    },
    "facilities": [
      { "facility_id": 107, "name": "Free WiFi", "category": null },
      { "facility_id": 301, "name": "Swimming pool", "category": null }
    ],
    "photos": [
      {
        "url": "https://example.test/1.jpg",
        "score": null,
        "hd_url": null,
        "class_id": null,
        "main_photo": null,
        "class_order": null,
        "image_class1": null,
        "image_class2": null,
        "image_description": null
      }
    ],
    "policies": [
      {
        "policy_id": 2,
        "policy_type": "POLICY_PET",
        "name": "Pets",
        "description": "Pets are not allowed."
      }
    ],
    "pricing_place_id": 77
  }
}

GET

hotels

{hotelId}

content

curl "$UNIFYSTAYS_BASE_URL/hotels/10001/content" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY"

{
  "success": true,
  "message": "Hotel content fetched successfully",
  "data": {
    "hotel_id": "1001",
    "hotel_name": "Example Hotel",
    "hotel_type": "Hotel",
    "chain": "Example Chain",
    "stars": 4,
    "main_image_url": "https://example.test/main.jpg",
    "markdown_description": "**Stay** by the beach",
    "important_info": "Line one\nLine two",
    "location": {
      "address": "123 Main Street",
      "address_local": null,
      "state": "Goa",
      "country": "IN",
      "postal_code": "403001",
      "latitude": 15.49,
      "longitude": 73.82
    },
    "contact": { "phone": "+91-1111", "email": "stay@example.test" },
    "checkin_policy": {
      "check_in_from": "14:00:00",
      "check_in_until": "24:00:00",
      "check_out_from": null,
      "check_out_until": "11:00:00",
      "special_instructions": "Front desk closes at 22:00",
      "instructions": ["Photo ID required", "Credit card required"]
    },
    "facilities": [
      { "facility_id": 107, "name": "Free WiFi", "category": null },
      { "facility_id": 301, "name": "Swimming pool", "category": null }
    ],
    "photos": [
      {
        "url": "https://example.test/1.jpg",
        "score": null,
        "hd_url": null,
        "class_id": null,
        "main_photo": null,
        "class_order": null,
        "image_class1": null,
        "image_class2": null,
        "image_description": null
      }
    ],
    "policies": [
      {
        "policy_id": 2,
        "policy_type": "POLICY_PET",
        "name": "Pets",
        "description": "Pets are not allowed."
      }
    ],
    "pricing_place_id": 77
  }
}

Use this endpoint to build a property detail page, or any place that needs static information about a hotel around a booking flow. It returns content from the Unifystays catalogue and never calls a supplier, so it is fast and safe to cache. It contains no prices and no room availability: for those, call Get Room Options after the guest picks the hotel and dates.

Request Example

curl "$UNIFYSTAYS_BASE_URL/hotels/10001/content" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY"

hotelId is the Unifystays hotel ID from Search Hotels or Destination Autocomplete. An unknown or non-numeric ID returns 404. Content is returned in English.

Response Example

{
  "success": true,
  "message": "Hotel content fetched successfully",
  "data": {
    "hotel_id": "1001",
    "hotel_name": "Example Hotel",
    "hotel_type": "Hotel",
    "chain": "Example Chain",
    "stars": 4,
    "main_image_url": "https://example.test/main.jpg",
    "markdown_description": "**Stay** by the beach",
    "important_info": "Line one\nLine two",
    "location": {
      "address": "123 Main Street",
      "address_local": null,
      "state": "Goa",
      "country": "IN",
      "postal_code": "403001",
      "latitude": 15.49,
      "longitude": 73.82
    },
    "contact": { "phone": "+91-1111", "email": "stay@example.test" },
    "checkin_policy": {
      "check_in_from": "14:00:00",
      "check_in_until": "24:00:00",
      "check_out_from": null,
      "check_out_until": "11:00:00",
      "special_instructions": "Front desk closes at 22:00",
      "instructions": ["Photo ID required", "Credit card required"]
    },
    "facilities": [
      { "facility_id": 107, "name": "Free WiFi", "category": null },
      { "facility_id": 301, "name": "Swimming pool", "category": null }
    ],
    "photos": [
      {
        "url": "https://example.test/1.jpg",
        "score": null,
        "hd_url": null,
        "class_id": null,
        "main_photo": null,
        "class_order": null,
        "image_class1": null,
        "image_class2": null,
        "image_description": null
      }
    ],
    "policies": [
      {
        "policy_id": 2,
        "policy_type": "POLICY_PET",
        "name": "Pets",
        "description": "Pets are not allowed."
      }
    ],
    "pricing_place_id": 77
  }
}

Field guide

Field	What it means	How to use it
`hotel_id`, `hotel_name`	Unifystays ID and the hotel’s name	Page title. Use `hotel_id` as your cache key.
`hotel_type`, `chain`	Property type (Hotel, Apartment…) and chain or brand; `null` when unknown or independent	Optional badges. Do not switch on the type text.
`stars`	Whole number from 0 to 5	`0` means unrated, not zero stars. Hide the rating then.
`main_image_url`	Lead image	Use on lists and as a page header. `null` when none.
`markdown_description`	English description as Markdown	Render as Markdown and sanitise it.
`important_info`	Notices from the hotel; lines separated by a newline	Show prominently on the property page.
`location.address`	English (Latin script) address whenever one is available	Display this.
`location.address_local`	Original address in the local script when it is not Latin; `null` otherwise	Optional local-language line.
`location.country`	ISO 3166-1 alpha-2 country code (not the name)	Map to a name yourself.
`location.state`, `postal_code`, `latitude`, `longitude`	Region, postal code and coordinates; each `null` when unknown	Use coordinates for a map.
`contact.phone`, `contact.email`	The first phone number and email on record	Show for guest information. Use the booking APIs, not this email, for changes to a booking.
`checkin_policy.check_in_from` / `check_in_until`	Check-in window, hotel local time, `HH:MM:SS`. `24:00:00` means midnight	Show “Check-in from 14:00”. Times have no time zone; they are local to the hotel.
`checkin_policy.check_out_from` / `check_out_until`	Check-out window, same format	Most hotels give only `check_out_until`.
`checkin_policy.special_instructions`, `instructions[]`	Free-text note and a list of arrival instructions	Show them with the times.
`checkin_policy`	`null` when the hotel published none of the above	Hide the section.
`facilities[]`	`{ facility_id, name, category }` objects sorted by name; `category` is always `null` today	Render as a list or icons by name. Names can be reworded; do not match on them. `null` when none are known.
`photos[]`	Objects in display order. Only `url` is filled; the other keys are always `null`	Use `url`. Treat URLs as opaque. `null` when the hotel has no photos.
`policies[]`	`{ policy_id, policy_type, name, description }` in the hotel’s own order, for example pets or children	Show as expandable sections. `null` when none. These are property rules, not the rate’s cancellation terms.
`pricing_place_id`	Place the hotel is grouped under for pricing and search; `null` when unassigned	Safe to ignore unless you group hotels by place.

Every list is null (not an empty array) when the hotel has no data for it. Check for null before iterating.

Caching

Content changes rarely and the call has no price or availability in it. Cache it by hotel_id with an expiry that suits your product (a few hours to a day is a sensible default). Use your own expiry: the response does not tell you when the content last changed.

Content does not guarantee a current price, room availability or a bookable rate. Room-level details (photos, beds, size) come with the offers from Get Room Options, grouped by room type.

Next step

Use Get Room Options once the guest has chosen the hotel and stay details.

Authorizations

x-api-key

string

header

required

Environment-specific API key created in the Unifystays portal

Headers

X-Unifystays-Contract-Version

enum<string>

default:2

Hotel API contract version. Optional: 2 is the current version and the default.

Available options:

2

X-Unifystays-Currency

string

ISO 4217 currency for display amounts (display_ledger, display_amount, commercial_display). Optional: defaults to your organization's display currency, USD unless configured. Read pricing.display_currency in the response.

Required string length: 3

Example:

"EUR"

Path Parameters

hotelId

string

required

Unifystays hotel ID from hotel search or destination autocomplete (numeric string). Unknown or non-numeric IDs return 404.

Example:

"10001"

Response

Hotel content returned successfully.

success

boolean

required

Always true on a 200 response.

Example:

true

message

string

required

Human-readable status. Do not parse it.

Example:

"Hotel content fetched successfully"

data

object

required

The hotel content.

Show child attributes

Overview

Destination & master data

Search & hotels

Bookings

Webhook endpoints

Webhook logs

Request Example

Response Example

Field guide

Caching

Next step

Authorizations

Headers

Path Parameters

Response

​Request Example

​Response Example

​Field guide

​Caching

​Next step

Authorizations

Headers

Path Parameters

Response

Request Example

Response Example

Field guide

Caching

Next step