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
}Search hotels by destination and return available rooms with live pricing
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
}Hotel shop request
Dates (required)
Options
Filter overrides
Occupancies — structured or shorthand
Show child attributes
Destination — at least one must be set