---
title: "Fetch rich metadata (gallery, facilities, policies, per-room details) for a single hotel"
method: GET
path: "/v1/hotel_details/{hotel_id}"
tags: ["Hotels"]
---

# Fetch rich metadata (gallery, facilities, policies, per-room details) for a single hotel

`GET /v1/hotel_details/{hotel_id}`

## Request

- Base URL: `https://api.gojinko.com`
- URL: `https://api.gojinko.com/v1/hotel_details/{hotel_id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

## Path parameters

- `hotel_id` string, required: The `hotel_id` of a hotel from hotel_search, passed exactly as received and URL-encoded as one path segment. It is opaque: do not parse or build it.

## Query parameters

- `checkin` string
- `checkout` string

## Response `200`

Hotel detail

- HotelDetailsResponse
  - `hotel` object
    - `id` string: Opaque hotel identifier, the value hotel_search returns as `hotel_id`. Pass it back exactly as received; do not parse or build it.
    - `hotel_ref` string: Deprecated: use `hotel_id` (search) or `id` (details, reviews). The hotel's identifier behind a source prefix, as earlier contract versions returned it; hotel_details and hotel_reviews still accept it. Pass it back exactly as received; do not parse or build it.
    - `name` string
    - `description` string
    - `star_rating` number
    - `rating` number: Guest score out of 10.
    - `review_count` integer: Number of guest reviews behind `rating`.
    - `child_allowed` boolean: Whether the property accepts children. Absent when the property does not say; `false` is a stated no.
    - `pets_allowed` boolean: Whether the property accepts pets. Absent when the property does not say; `false` is a stated no.
    - `address` string
    - `city` string
    - `country_code` string
    - `coordinates` object
      - `latitude` number
      - `longitude` number
    - `images` string[]
    - `facilities` string[]
    - `facility_items` object[]: Facilities as dictionary entries: `id` is the Jinko facility dictionary id (the value `facility_ids` accepts on hotel_search), `label` the English label. Facilities without a dictionary id appear in `facilities` only.
      - `id` integer, required: Stable numeric id.
      - `label` string, required: English label.
    - `policies` HotelPolicy[]
      - `name` string
      - `description` string
      - `policy_type` string
      - `child_allowed` boolean: Whether this policy says the property accepts children. Absent when it does not say.
      - `pets_allowed` boolean: Whether this policy says the property accepts pets. Absent when it does not say.
    - `check_in_time` string
    - `check_out_time` string
  - `rooms` HotelDetailsRoom[]: Room-level metadata for this property. These are DESCRIPTIVE only and carry no price — `room_id` correlates them to the priced rooms in a hotel_search response.
    - `id` string
    - `name` string
    - `description` string
    - `amenities` string[]
    - `amenity_items` object[]: Room amenities with a stable amenity id. Room amenity ids are a separate list from the facility dictionary.
      - `id` integer, required: Stable numeric id.
      - `label` string, required: English label.
    - `bed_types` string[]
    - `room_capacity` integer: How many the room sleeps, from the property’s own room metadata. Same field as on hotel_search and on a hotel trip item.
    - `max_occupancy` integer: Deprecated: use `room_capacity` (same value).
    - `max_adults` integer: Maximum number of adults the room accepts.
    - `max_children` integer: Maximum number of children the room accepts; 0 means the room does not take children.
    - `size_sqm` number
    - `views` string[]
    - `images` string[]

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `402`: Payment required — organization balance exhausted
- `404`: Resource not found
- `409`: The operation conflicts with the current state of the resource
- `410`: The resource this request names no longer exists
- `422`: Validation error
- `429`: Rate limit or quota exceeded
- `502`: The travel provider rejected the request, or an upstream call failed
- `503`: No travel provider can serve the request right now
- `504`: The travel provider did not answer in time

---

[API](https://skmtc.dev/gojinko/apis/jinko-public-api.md) - [All operations](https://skmtc.dev/gojinko/apis/jinko-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gojinko/apis/jinko-public-api/revisions/ac5046767e4c?raw)