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
    • API key in header X-API-Key
    • or HTTP bearer

Path parameters

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

Example:lp1d2c3

Query parameters

checkinstring
checkoutstring

Response

Hotel detail

Example response

{
  "hotel": {
    "id": "lp1d2c3",
    "hotel_ref": "h1:lp1d2c3",
    "name": "Hôtel Le Marais",
    "description": "A boutique 4-star hotel in the heart of the Marais district.",
    "star_rating": 4,
    "rating": 8.6,
    "review_count": 1243,
    "child_allowed": true,
    "address": "12 Rue de Rivoli",
    "city": "Paris",
    "country_code": "FR",
    "coordinates": {
      "latitude": 48.8566,
      "longitude": 2.3522
    },
    "images": [
      "https://images.gojinko.com/hotels/htl_8f21a9c0/1.jpg"
    ],
    "facilities": [
      "Free WiFi",
      "Air conditioning",
      "24-hour front desk"
    ],
    "facility_items": [
      {
        "id": 107,
        "label": "Free WiFi"
      },
      {
        "id": 2,
        "label": "Air conditioning"
      }
    ],
    "policies": [
      {
        "name": "Pets",
        "description": "Pets are not allowed.",
        "policy_type": "pets",
        "child_allowed": true
      }
    ],
    "check_in_time": "15:00",
    "check_out_time": "11:00"
  },
  "rooms": [
    {
      "id": "rm_1",
      "name": "Superior Double",
      "amenities": [
        "Air conditioning",
        "Safe"
      ],
      "amenity_items": [
        {
          "id": 312,
          "label": "Shower"
        },
        {
          "id": 339,
          "label": "TV"
        }
      ],
      "bed_types": [
        "1 double bed"
      ],
      "room_capacity": 2,
      "max_occupancy": 2,
      "max_adults": 2,
      "max_children": 1,
      "size_sqm": 18.5,
      "views": [
        "Courtyard"
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.