flights
- POSTSearch destinations by flight criteria
- POSTCommit a flight exchange
- POSTPrice a specific exchange offer
- POSTSearch for flight exchange options
- POSTCheck the status of a flight exchange
- POSTCheck flight refund eligibility
- POSTInitiate a refund for a booked flight
- POSTCheck the status of a refund
- POSTSearch flights (synchronous, filter-based)
devplatform-flights
hotels
Search destinations by flight criteria
curl --request POST \
--url https://mcp-bff.gojinko.com/api/v1/flights/destination-search \
--header 'Content-Type: application/json' \
--data '
{
"currency": "<string>",
"filters": {
"cabin_class": "economy",
"dates": {
"departure_date_ranges": [
{
"end": "<string>",
"start": "<string>"
}
],
"departure_dates": [
"<string>"
],
"return_date_ranges": [
{
"end": "<string>",
"start": "<string>"
}
],
"return_dates": [
"<string>"
],
"stay_days": 123,
"stay_days_range": {
"max": 123,
"min": 123
}
},
"direct_only": true,
"locations": {
"destination_type": "<string>",
"destinations": [
"<string>"
],
"origin_type": "<string>",
"origins": [
"<string>"
]
},
"trip_type": "oneway"
},
"flights_per_destination": 123,
"limit": 123,
"locale": "<string>",
"offset": 123,
"passengers": {
"adt": 123,
"ages": [
123
],
"chd": 123,
"inf_lap": 123,
"inf_seat": 123,
"residency_country": "<string>",
"student": 123,
"youth": 123
},
"price_constraints": {
"max_total": 123
},
"sort": "lowest"
}
'{
"destinations": [
{
"city_main_image": "<string>",
"city_name": "<string>",
"flights": [
{
"cabin_type": "economy",
"conversion_rate": 123,
"deep_link": "<string>",
"destination_city_code": "<string>",
"destination_city_image": "<string>",
"destination_city_location": {
"latitude": 123,
"longitude": 123
},
"destination_city_name": "<string>",
"fare_brand": "<string>",
"id": "<string>",
"jinko_advice": {
"description": "<string>",
"label": "Lowest",
"quantiles": {
"max_fare": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"min_fare": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"percentile_25": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"percentile_50": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"percentile_75": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
}
},
"title": "<string>"
},
"origin_city_code": "<string>",
"origin_city_location": {
"latitude": 123,
"longitude": 123
},
"origin_city_name": "<string>",
"origin_total_amount": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"score": 123,
"search_timestamp": "<string>",
"slices": [
{
"cabin": "economy",
"destination": "<string>",
"destination_airport_name": "<string>",
"destination_city_name": "<string>",
"duration_minutes": 123,
"marketing_carrier_info": {
"code": "<string>",
"is_lcc": true,
"logo": "<string>",
"name": "<string>"
},
"origin": "<string>",
"origin_airport_name": "<string>",
"origin_city_name": "<string>",
"segments": [
{
"aircraft": "<string>",
"arrive": {
"airport": "<string>",
"city_code": "<string>",
"city_name": "<string>",
"terminal": "<string>",
"time_local": "<string>"
},
"depart": {
"airport": "<string>",
"city_code": "<string>",
"city_name": "<string>",
"terminal": "<string>",
"time_local": "<string>"
},
"duration_minutes": 123,
"flight_number": "<string>",
"layover_minutes_after": 123,
"marketing_carrier": "<string>",
"marketing_carrier_info": {
"code": "<string>",
"is_lcc": true,
"logo": "<string>",
"name": "<string>"
},
"operating_carrier": "<string>",
"operating_carrier_info": {
"code": "<string>",
"is_lcc": true,
"logo": "<string>",
"name": "<string>"
}
}
]
}
],
"total_amount": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
}
}
],
"iata_code": "<string>",
"location": {
"latitude": 123,
"longitude": 123
},
"lowest_fare_flight": {
"cabin_type": "economy",
"conversion_rate": 123,
"deep_link": "<string>",
"destination_city_code": "<string>",
"destination_city_image": "<string>",
"destination_city_location": {
"latitude": 123,
"longitude": 123
},
"destination_city_name": "<string>",
"fare_brand": "<string>",
"id": "<string>",
"jinko_advice": {
"description": "<string>",
"label": "Lowest",
"quantiles": {
"max_fare": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"min_fare": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"percentile_25": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"percentile_50": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"percentile_75": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
}
},
"title": "<string>"
},
"origin_city_code": "<string>",
"origin_city_location": {
"latitude": 123,
"longitude": 123
},
"origin_city_name": "<string>",
"origin_total_amount": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"score": 123,
"search_timestamp": "<string>",
"slices": [
{
"cabin": "economy",
"destination": "<string>",
"destination_airport_name": "<string>",
"destination_city_name": "<string>",
"duration_minutes": 123,
"marketing_carrier_info": {
"code": "<string>",
"is_lcc": true,
"logo": "<string>",
"name": "<string>"
},
"origin": "<string>",
"origin_airport_name": "<string>",
"origin_city_name": "<string>",
"segments": [
{
"aircraft": "<string>",
"arrive": {
"airport": "<string>",
"city_code": "<string>",
"city_name": "<string>",
"terminal": "<string>",
"time_local": "<string>"
},
"depart": {
"airport": "<string>",
"city_code": "<string>",
"city_name": "<string>",
"terminal": "<string>",
"time_local": "<string>"
},
"duration_minutes": 123,
"flight_number": "<string>",
"layover_minutes_after": 123,
"marketing_carrier": "<string>",
"marketing_carrier_info": {
"code": "<string>",
"is_lcc": true,
"logo": "<string>",
"name": "<string>"
},
"operating_carrier": "<string>",
"operating_carrier_info": {
"code": "<string>",
"is_lcc": true,
"logo": "<string>",
"name": "<string>"
}
}
]
}
],
"total_amount": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
}
}
}
],
"origin": {
"city_code": "<string>",
"city_name": "<string>",
"country_code": "<string>",
"country_name": "<string>",
"location": {
"latitude": 123,
"longitude": 123
}
},
"pagination": {
"next_page_token": "<string>"
},
"total": 123
}flights
Search destinations by flight criteria
Search for destination cities with cheapest flight options based on filter criteria
POST
/
api
/
v1
/
flights
/
destination-search
Search destinations by flight criteria
curl --request POST \
--url https://mcp-bff.gojinko.com/api/v1/flights/destination-search \
--header 'Content-Type: application/json' \
--data '
{
"currency": "<string>",
"filters": {
"cabin_class": "economy",
"dates": {
"departure_date_ranges": [
{
"end": "<string>",
"start": "<string>"
}
],
"departure_dates": [
"<string>"
],
"return_date_ranges": [
{
"end": "<string>",
"start": "<string>"
}
],
"return_dates": [
"<string>"
],
"stay_days": 123,
"stay_days_range": {
"max": 123,
"min": 123
}
},
"direct_only": true,
"locations": {
"destination_type": "<string>",
"destinations": [
"<string>"
],
"origin_type": "<string>",
"origins": [
"<string>"
]
},
"trip_type": "oneway"
},
"flights_per_destination": 123,
"limit": 123,
"locale": "<string>",
"offset": 123,
"passengers": {
"adt": 123,
"ages": [
123
],
"chd": 123,
"inf_lap": 123,
"inf_seat": 123,
"residency_country": "<string>",
"student": 123,
"youth": 123
},
"price_constraints": {
"max_total": 123
},
"sort": "lowest"
}
'{
"destinations": [
{
"city_main_image": "<string>",
"city_name": "<string>",
"flights": [
{
"cabin_type": "economy",
"conversion_rate": 123,
"deep_link": "<string>",
"destination_city_code": "<string>",
"destination_city_image": "<string>",
"destination_city_location": {
"latitude": 123,
"longitude": 123
},
"destination_city_name": "<string>",
"fare_brand": "<string>",
"id": "<string>",
"jinko_advice": {
"description": "<string>",
"label": "Lowest",
"quantiles": {
"max_fare": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"min_fare": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"percentile_25": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"percentile_50": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"percentile_75": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
}
},
"title": "<string>"
},
"origin_city_code": "<string>",
"origin_city_location": {
"latitude": 123,
"longitude": 123
},
"origin_city_name": "<string>",
"origin_total_amount": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"score": 123,
"search_timestamp": "<string>",
"slices": [
{
"cabin": "economy",
"destination": "<string>",
"destination_airport_name": "<string>",
"destination_city_name": "<string>",
"duration_minutes": 123,
"marketing_carrier_info": {
"code": "<string>",
"is_lcc": true,
"logo": "<string>",
"name": "<string>"
},
"origin": "<string>",
"origin_airport_name": "<string>",
"origin_city_name": "<string>",
"segments": [
{
"aircraft": "<string>",
"arrive": {
"airport": "<string>",
"city_code": "<string>",
"city_name": "<string>",
"terminal": "<string>",
"time_local": "<string>"
},
"depart": {
"airport": "<string>",
"city_code": "<string>",
"city_name": "<string>",
"terminal": "<string>",
"time_local": "<string>"
},
"duration_minutes": 123,
"flight_number": "<string>",
"layover_minutes_after": 123,
"marketing_carrier": "<string>",
"marketing_carrier_info": {
"code": "<string>",
"is_lcc": true,
"logo": "<string>",
"name": "<string>"
},
"operating_carrier": "<string>",
"operating_carrier_info": {
"code": "<string>",
"is_lcc": true,
"logo": "<string>",
"name": "<string>"
}
}
]
}
],
"total_amount": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
}
}
],
"iata_code": "<string>",
"location": {
"latitude": 123,
"longitude": 123
},
"lowest_fare_flight": {
"cabin_type": "economy",
"conversion_rate": 123,
"deep_link": "<string>",
"destination_city_code": "<string>",
"destination_city_image": "<string>",
"destination_city_location": {
"latitude": 123,
"longitude": 123
},
"destination_city_name": "<string>",
"fare_brand": "<string>",
"id": "<string>",
"jinko_advice": {
"description": "<string>",
"label": "Lowest",
"quantiles": {
"max_fare": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"min_fare": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"percentile_25": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"percentile_50": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"percentile_75": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
}
},
"title": "<string>"
},
"origin_city_code": "<string>",
"origin_city_location": {
"latitude": 123,
"longitude": 123
},
"origin_city_name": "<string>",
"origin_total_amount": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
},
"score": 123,
"search_timestamp": "<string>",
"slices": [
{
"cabin": "economy",
"destination": "<string>",
"destination_airport_name": "<string>",
"destination_city_name": "<string>",
"duration_minutes": 123,
"marketing_carrier_info": {
"code": "<string>",
"is_lcc": true,
"logo": "<string>",
"name": "<string>"
},
"origin": "<string>",
"origin_airport_name": "<string>",
"origin_city_name": "<string>",
"segments": [
{
"aircraft": "<string>",
"arrive": {
"airport": "<string>",
"city_code": "<string>",
"city_name": "<string>",
"terminal": "<string>",
"time_local": "<string>"
},
"depart": {
"airport": "<string>",
"city_code": "<string>",
"city_name": "<string>",
"terminal": "<string>",
"time_local": "<string>"
},
"duration_minutes": 123,
"flight_number": "<string>",
"layover_minutes_after": 123,
"marketing_carrier": "<string>",
"marketing_carrier_info": {
"code": "<string>",
"is_lcc": true,
"logo": "<string>",
"name": "<string>"
},
"operating_carrier": "<string>",
"operating_carrier_info": {
"code": "<string>",
"is_lcc": true,
"logo": "<string>",
"name": "<string>"
}
}
]
}
],
"total_amount": {
"currency": "<string>",
"decimal_places": 2,
"value": 123
}
}
}
],
"origin": {
"city_code": "<string>",
"city_name": "<string>",
"country_code": "<string>",
"country_name": "<string>",
"location": {
"latitude": 123,
"longitude": 123
}
},
"pagination": {
"next_page_token": "<string>"
},
"total": 123
}Body
application/json
Destination search request
Currency code for pricing (e.g., "USD", "EUR", "GBP")
Search filters (required)
Show child attributes
Show child attributes
FlightsPerDestination - number of flights to return per destination bucket (default: 1, max: 10)
Limit - maximum number of destinations to return (default: 20, max: 100)
Locale code for results (e.g., "en", "fr", "de", "es", "zh", "ja", "ko")
Offset - number of destinations to skip for pagination (default: 0)
Passengers (required for pricing)
Show child attributes
Show child attributes
Price constraints
Show child attributes
Show child attributes
Sort criteria: "lowest" (default) or "recommendation"
Available options:
lowest, recommendation ⌘I