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

# hotel-details

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

Pull the full marketing and operational profile of a single property after a search result catches the user's attention. Useful for questions like "what amenities does this hotel have", "is there a pool on site", or "what is the cancellation policy on the deluxe room". Returns the gallery, facilities, room metadata, and policies in one payload.


## OpenAPI

````yaml api-reference/public-api.yaml GET /v1/hotel_details/{hotel_id}
openapi: 3.0.0
info:
  title: Jinko Public API
  version: 0.125.0
  description: >-
    Curated public REST surface for Jinko. Authenticated with jnk_ API keys. See
    https://docs.gojinko.com for guides.


    ### Per-end-user attribution


    On booking calls you may send an optional `X-End-User-Id` request header to
    attribute the booking to one of your own end users (for per-end-user
    attribution and rate-limiting). The value is an **opaque, tenant-scoped**
    identifier that you choose — not a Jinko account id. Omit it to book as the
    tenant. Values prefixed `user_` or `org_` are rejected.
servers:
  - url: https://api.gojinko.com
    description: Production
  - url: https://api.sandbox.gojinko.com
    description: Sandbox
security: []
paths:
  /v1/hotel_details/{hotel_id}:
    get:
      tags:
        - Hotels
      summary: >-
        Fetch rich metadata (gallery, facilities, policies, per-room details)
        for a single hotel
      parameters:
        - schema:
            type: string
            description: >-
              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.
            example: lp1d2c3
          required: true
          name: hotel_id
          in: path
        - schema:
            type: string
          required: false
          name: checkin
          in: query
        - schema:
            type: string
          required: false
          name: checkout
          in: query
      responses:
        '200':
          description: Hotel detail
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HotelDetailsResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: BAD_REQUEST
                  message: Malformed JSON in request body.
                  doc_url: https://docs.gojinko.com/concepts/errors
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: AUTH_REQUIRED
                  message: Invalid or expired API key.
                  doc_url: https://docs.gojinko.com/authentication/api-keys
        '402':
          description: Payment required — organization balance exhausted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: PAYMENT_REQUIRED
                  message: >-
                    Insufficient balance — this call costs $0.0150 and your
                    organization has $0.0000 available. Top up at
                    https://dashboard.gojinko.com/developers/billing/topup
                  doc_url: https://docs.gojinko.com/concepts/errors
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: NOT_FOUND
                  message: Resource not found.
                  doc_url: https://docs.gojinko.com/concepts/errors
        '409':
          description: The operation conflicts with the current state of the resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: CONFLICT
                  message: >-
                    The operation conflicts with the current state of the
                    resource.
                  doc_url: https://docs.gojinko.com/concepts/errors
        '410':
          description: The resource this request names no longer exists
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: GONE
                  message: The resource no longer exists.
                  doc_url: https://docs.gojinko.com/concepts/errors
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: BAD_REQUEST
                  message: A required field is missing or invalid.
                  doc_url: https://docs.gojinko.com/concepts/errors
        '429':
          description: Rate limit or quota exceeded
          headers:
            Retry-After:
              description: >-
                Seconds to wait before retrying. Absent when no interval
                applies.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: RATE_LIMITED
                  message: Too many requests. Retry after the Retry-After delay.
                  doc_url: https://docs.gojinko.com/concepts/errors
        '502':
          description: The travel provider rejected the request, or an upstream call failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: UPSTREAM_REJECTED
                  message: The request was declined for this offer. Try another offer.
                  doc_url: https://docs.gojinko.com/concepts/errors
        '503':
          description: No travel provider can serve the request right now
          headers:
            Retry-After:
              description: >-
                Seconds to wait before retrying. Absent when no interval
                applies.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: UPSTREAM_UNAVAILABLE
                  message: >-
                    The service is temporarily unavailable. Retry after the
                    Retry-After delay.
                  doc_url: https://docs.gojinko.com/concepts/errors
        '504':
          description: The travel provider did not answer in time
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: UPSTREAM_TIMEOUT
                  message: >-
                    The request timed out before a result was available. Retry
                    the request.
                  doc_url: https://docs.gojinko.com/concepts/errors
      security:
        - ApiKeyAuth: []
        - BearerAuth: []
components:
  schemas:
    HotelDetailsResponse:
      type: object
      properties:
        hotel:
          type: object
          properties:
            id:
              type: string
              description: >-
                Opaque hotel identifier, the value hotel_search returns as
                `hotel_id`. Pass it back exactly as received; do not parse or
                build it.
              example: lp1d2c3
            hotel_ref:
              type: string
              description: >-
                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.
              example: h1:lp1d2c3
              deprecated: true
            name:
              type: string
              example: Hôtel Le Marais
            description:
              type: string
              example: A boutique 4-star hotel in the heart of the Marais district.
            star_rating:
              type: number
              example: 4
            rating:
              type: number
              description: Guest score out of 10.
              example: 8.6
            review_count:
              type: integer
              description: Number of guest reviews behind `rating`.
              example: 1243
            child_allowed:
              type: boolean
              description: >-
                Whether the property accepts children. Absent when the property
                does not say; `false` is a stated no.
              example: true
            pets_allowed:
              type: boolean
              description: >-
                Whether the property accepts pets. Absent when the property does
                not say; `false` is a stated no.
              example: false
            address:
              type: string
              example: 12 Rue de Rivoli
            city:
              type: string
              example: Paris
            country_code:
              type: string
              example: FR
            coordinates:
              type: object
              properties:
                latitude:
                  type: number
                longitude:
                  type: number
              example:
                latitude: 48.8566
                longitude: 2.3522
            images:
              type: array
              items:
                type: string
              example:
                - https://images.gojinko.com/hotels/htl_8f21a9c0/1.jpg
            facilities:
              type: array
              items:
                type: string
              example:
                - Free WiFi
                - Air conditioning
                - 24-hour front desk
            facility_items:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: integer
                    description: Stable numeric id.
                  label:
                    type: string
                    description: English label.
                required:
                  - id
                  - label
              description: >-
                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.
              example:
                - id: 107
                  label: Free WiFi
                - id: 2
                  label: Air conditioning
            policies:
              type: array
              items:
                $ref: '#/components/schemas/HotelPolicy'
            check_in_time:
              type: string
              example: '15:00'
            check_out_time:
              type: string
              example: '11:00'
        rooms:
          type: array
          items:
            $ref: '#/components/schemas/HotelDetailsRoom'
          description: >-
            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.
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - INVALID_SEGMENTS_TO_EXCHANGE
                - PARTIAL_EXCHANGE_UNSUPPORTED
                - LEG_ALREADY_DEPARTED
                - DEPARTURE_DATE_IN_PAST
                - LEG_DATES_OUT_OF_ORDER
                - INVALID_EXCHANGE_REQUEST
                - NOT_EXCHANGEABLE
                - CREDENTIAL_FORMAT_INVALID
                - PAYMENT_TYPE_NOT_ENABLED
                - PAYMENT_CREDENTIAL_INVALID
                - TRIP_OWNED_BY_OTHER_PAYMENT
                - IDEMPOTENCY_KEY_REUSED
                - ATTEMPT_IN_PROGRESS
                - ATTEMPT_TERMINAL
                - TEMPORARILY_UNAVAILABLE
                - AUTH_REQUIRED
                - PAYMENT_REQUIRED
                - RATE_LIMITED
                - BAD_REQUEST
                - FORBIDDEN
                - NOT_FOUND
                - CONFLICT
                - GONE
                - QUOTE_PENDING
                - QUOTE_EXPIRED
                - TRIP_EXPIRED
                - TRIP_STATE_CONFLICT
                - OFFER_EXPIRED
                - OFFER_UNAVAILABLE
                - MISSING_CUSTOMER_DETAILS
                - INVALID_PHONE_NUMBER
                - INVALID_FLIGHT_NUMBER
                - CURRENCY_UNSUPPORTED
                - HOTEL_NAME_LOW_CONFIDENCE
                - DESTINATION_LOW_CONFIDENCE
                - UPSTREAM_REJECTED
                - UPSTREAM_UNAVAILABLE
                - UPSTREAM_TIMEOUT
                - UPSTREAM_ERROR
                - INTERNAL
              description: >-
                What went wrong, as a stable machine-readable code. This is a
                closed set — branch on it rather than on `message`, which is
                prose and may change. New codes arrive in a minor version, so
                treat an unknown one as its HTTP status. A code can also stop
                being emitted: it leaves this set in a minor version, named in
                the changelog, and a branch you wrote for it goes unreached
                rather than wrong.
              example: BAD_REQUEST
            message:
              type: string
              description: >-
                What went wrong, in prose. These codes always carry the same
                message, and it never includes text from a supplier:
                `RATE_LIMITED` — "Too many requests. Retry after the Retry-After
                delay."; `OFFER_EXPIRED` — "This offer has expired. Search
                again."; `OFFER_UNAVAILABLE` — "This offer is no longer
                available. Search again."; `UPSTREAM_REJECTED` — "The request
                was declined for this offer. Try another offer.";
                `UPSTREAM_UNAVAILABLE` — "The service is temporarily
                unavailable. Retry after the Retry-After delay.";
                `UPSTREAM_TIMEOUT` — "The request timed out before a result was
                available. Retry the request."; `UPSTREAM_ERROR` — "The request
                could not be completed.".
            doc_url:
              type: string
            field:
              type: string
              description: >-
                On a 400 `BAD_REQUEST` that names one refused input: the path of
                that field in your request, e.g. `selections[1].quantity` for
                the second selection of a `select_ancillaries` call. Absent when
                the refusal names no single field.
              example: selections[1].quantity
          required:
            - code
            - message
      required:
        - error
    HotelPolicy:
      type: object
      properties:
        name:
          type: string
          example: Pets
        description:
          type: string
          example: Pets are not allowed.
        policy_type:
          type: string
          example: pets
        child_allowed:
          type: boolean
          description: >-
            Whether this policy says the property accepts children. Absent when
            it does not say.
          example: true
        pets_allowed:
          type: boolean
          description: >-
            Whether this policy says the property accepts pets. Absent when it
            does not say.
          example: false
    HotelDetailsRoom:
      type: object
      properties:
        id:
          type: string
          example: rm_1
        name:
          type: string
          example: Superior Double
        description:
          type: string
        amenities:
          type: array
          items:
            type: string
          example:
            - Air conditioning
            - Safe
        amenity_items:
          type: array
          items:
            type: object
            properties:
              id:
                type: integer
                description: Stable numeric id.
              label:
                type: string
                description: English label.
            required:
              - id
              - label
          description: >-
            Room amenities with a stable amenity id. Room amenity ids are a
            separate list from the facility dictionary.
          example:
            - id: 312
              label: Shower
            - id: 339
              label: TV
        bed_types:
          type: array
          items:
            type: string
          example:
            - 1 double bed
        room_capacity:
          type: integer
          description: >-
            How many the room sleeps, from the property’s own room metadata.
            Same field as on hotel_search and on a hotel trip item.
          example: 2
        max_occupancy:
          type: integer
          description: 'Deprecated: use `room_capacity` (same value).'
          deprecated: true
          example: 2
        max_adults:
          type: integer
          description: Maximum number of adults the room accepts.
          example: 2
        max_children:
          type: integer
          description: >-
            Maximum number of children the room accepts; 0 means the room does
            not take children.
          example: 1
        size_sqm:
          type: number
          example: 18.5
        views:
          type: array
          items:
            type: string
          example:
            - Courtyard
        images:
          type: array
          items:
            type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
    BearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.