> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unifystays.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Hotel Content

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

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

<RequestExample>
  ```bash theme={null}
  curl "$UNIFYSTAYS_BASE_URL/hotels/123456/content" \
    -H "x-api-key: $UNIFYSTAYS_API_KEY" \
    -H "language: en"
  ```
</RequestExample>

## 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.

<Info>
  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.
</Info>

Use [Get Room Options](/api-reference/hotel-rooms) 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.


## OpenAPI

````yaml reference/openapi.json GET /hotels/{hotelId}/content
openapi: 3.0.0
info:
  title: Unifystays API
  description: >-
    One unified hotel API across suppliers. Integrate once, then enable and
    manage suppliers from the Unifystays portal.
  version: '1.0'
  contact: {}
servers:
  - url: https://api-sandbox.unifystays.com
    description: Sandbox
  - url: https://api.unifystays.com
    description: Production
security:
  - x-api-key: []
tags: []
paths:
  /hotels/{hotelId}/content:
    get:
      tags:
        - Hotels
      summary: Get hotel static content
      description: >-
        Returns all static (non-pricing) details for a single hotel identified
        by `hotelId`. This includes descriptive copy, location, contact,
        check-in policy, facilities, photos, hotel-level policies, and the full
        list of room types with their amenities, bed types, and room-level
        photos. 


        This endpoint reads exclusively from the local database — it makes no
        provider API call and is therefore fast and cacheable.
      operationId: HotelContentController_getHotelContent
      parameters:
        - name: hotelId
          required: true
          in: path
          description: Internal hotel_id (bigint stored as string).
          schema:
            type: string
            example: '10001'
        - name: language
          description: Enter language code(ex. en)
          in: header
          schema: {}
      responses:
        '200':
          description: Hotel content returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HotelContentResponseDto'
        '400':
          description: Bad request
        '404':
          description: Entity not found
components:
  schemas:
    HotelContentResponseDto:
      type: object
      properties:
        success:
          type: boolean
          example: true
        message:
          type: string
          example: Hotel content fetched successfully
        data:
          $ref: '#/components/schemas/HotelContentDto'
      required:
        - success
        - message
        - data
    HotelContentDto:
      type: object
      properties:
        hotel_id:
          type: string
          example: '10001'
        hotel_name:
          type: string
          example: Taj Mahal Palace
        hotel_type:
          type: object
          example: Hotel
        chain:
          type: object
          example: Taj Hotels
        stars:
          type: object
          example: 5
        main_image_url:
          type: object
          example: https://cdn.example.com/taj-main.jpg
        markdown_description:
          type: object
          description: Markdown-formatted description for rich rendering.
        important_info:
          type: object
          description: Important notices, terms, or advisories.
        location:
          $ref: '#/components/schemas/HotelLocationDto'
        contact:
          $ref: '#/components/schemas/HotelContactDto'
        checkin_policy:
          $ref: '#/components/schemas/CheckinPolicyDto'
        facilities:
          type: object
          description: Hotel-level facilities (JSONB from import pipeline).
          example:
            - Swimming Pool
            - Spa
            - Restaurant
            - Free Wi-Fi
        photos:
          type: object
          description: Hotel-level photos (JSONB from import pipeline).
          example:
            - url: https://cdn.example.com/lobby.jpg
              caption: Lobby
        policies:
          type: object
          description: Hotel policies — pets, smoking, cancellation, etc. (JSONB).
        city_id:
          type: object
          example: 101
      required:
        - hotel_id
        - hotel_name
        - location
        - contact
    HotelLocationDto:
      type: object
      properties:
        address:
          type: object
          example: 123 Marine Drive
        city:
          type: string
          example: Mumbai
        state:
          type: object
          example: Maharashtra
        country:
          type: string
          example: India
        postal_code:
          type: object
          example: '400001'
        latitude:
          type: object
          example: 18.9388
        longitude:
          type: object
          example: 72.8354
      required:
        - city
        - country
    HotelContactDto:
      type: object
      properties:
        phone:
          type: object
          example: +91-22-66651234
        email:
          type: object
          example: reservations@tajhotels.com
    CheckinPolicyDto:
      type: object
      properties:
        check_in_from:
          type: object
          example: '14:00'
          description: Earliest check-in time (checkin_start).
        check_in_until:
          type: object
          example: '23:00'
          description: Latest check-in time (checkin_end).
        check_out_from:
          type: object
          example: '07:00'
          description: Earliest check-out time (checkout_start).
        check_out_until:
          type: object
          example: '12:00'
          description: Latest check-out time (checkout_end).
        special_instructions:
          type: object
          example: Photo ID required at check-in.
          description: Free-text special instructions.
        instructions:
          description: >-
            Structured check-in instruction lines
            (hotel_checkin_info.instructions).
          example:
            - Front desk open 24 hours
            - 'Late check-in: please call ahead'
          type: array
          items:
            type: string
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: Environment-specific API key created in the Unifystays portal

````