Skip to main content
POST
/
api
/
v1
/
hotels
/
shop
Shop hotel rates
curl --request POST \
  --url https://mcp-bff.gojinko.com/api/v1/hotels/shop \
  --header 'Content-Type: application/json' \
  --data '
{
  "checkin": "<string>",
  "checkout": "<string>",
  "adults": 123,
  "chain_ids": [
    "<string>"
  ],
  "children": [
    123
  ],
  "city_name": "<string>",
  "country_code": "<string>",
  "currency": "<string>",
  "facility_ids": [
    "<string>"
  ],
  "guest_nationality": "<string>",
  "hotel_ids": [
    "<string>"
  ],
  "hotel_type_ids": [
    "<string>"
  ],
  "latitude": 123,
  "longitude": 123,
  "max_results": 123,
  "min_rating": 123,
  "min_reviews": 123,
  "occupancies": [
    {
      "adults": 123,
      "children_ages": [
        123
      ]
    }
  ],
  "place_id": "<string>",
  "query": "<string>",
  "radius_km": 123,
  "rooms": 123,
  "star_rating": 123
}
'
{
  "hotels": [
    {
      "address": "<string>",
      "city": "<string>",
      "country": "<string>",
      "hotel_id": "<string>",
      "latitude": 123,
      "longitude": 123,
      "main_photo": "<string>",
      "name": "<string>",
      "rating": 123,
      "review_count": 123,
      "rooms": [
        {
          "description": "<string>",
          "max_occupancy": 123,
          "rates": [
            {
              "board_name": "<string>",
              "board_type": "<string>",
              "cancellation_schedule": [
                {
                  "amount": 123,
                  "cancel_time": "<string>",
                  "currency": "<string>",
                  "type": "<string>"
                }
              ],
              "currency": "<string>",
              "free_cancellation_until": "<string>",
              "is_refundable": true,
              "offer_id": "<string>",
              "payment_types": [
                "<string>"
              ],
              "semantic_matches": {
                "board_type": true,
                "max_price": true,
                "refundable": true
              },
              "taxes_breakdown": [
                {
                  "amount": 123,
                  "currency": "<string>",
                  "description": "<string>",
                  "included": true
                }
              ],
              "total_amount": 123
            }
          ],
          "room_id": "<string>",
          "room_name": "<string>"
        }
      ],
      "star_rating": 123,
      "thumbnail": "<string>"
    }
  ],
  "total": 123
}

Body

application/json

Hotel shop request

checkin
string
required

Dates (required)

checkout
string
required
adults
integer
chain_ids
string[]
children
integer[]
city_name
string
country_code
string
currency
string

Options

facility_ids
string[]
guest_nationality
string
hotel_ids
string[]
hotel_type_ids
string[]
latitude
number
longitude
number
max_results
integer
min_rating
number

Filter overrides

min_reviews
integer
occupancies
object[]

Occupancies — structured or shorthand

place_id
string
query
string

Destination — at least one must be set

radius_km
number
rooms
integer
star_rating
integer

Response

OK

hotels
object[]
total
integer