{"openapi":"3.2.0","info":{"title":"SkyFare API","description":"Search flights across multiple providers in a single API call. Compare real-time prices from Skyscanner, Jetcost, Skiplagged, Kiwi.com & Trip.com — deduplicated, normalized, with direct booking links.","version":"1.0.0"},"servers":[{"url":"https://qqhcw.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"list_providers"},{"name":"search_airports"},{"name":"explore"},{"name":"health_check"},{"name":"calendar"},{"name":"trends"},{"name":"search_flights"}],"x-agent-commerce":{"catalog_url":"https://qqhcw.jojapi.net/_jojapi/agent/plans","discovery_url":"https://qqhcw.jojapi.net/.well-known/x402","directory_url":"https://agents.jojapi.net/apis/skyfare-api","docs":"https://docs.jojapi.com/consumers/agents"},"paths":{"/list_providers":{"get":{"operationId":"get_list_providers","summary":"/list_providers","description":"Retrieve the list of supported flight providers.","tags":["list_providers"],"responses":{"200":{"description":"Successful execution","content":{"application/json":{"schema":{"type":"object"},"examples":{"Example_1":{"value":{"status":"completed","extracted":{"providers":["kiwi","trip","skiplagged","skyscanner","jetcost"]}}}}}}}}}},"/search_airports":{"get":{"operationId":"get_search_airports","summary":"/search_airports","description":"Search airports by city name or code.","tags":["search_airports"],"responses":{"200":{"description":"Successful execution","content":{"application/json":{"schema":{"type":"object"},"examples":{"Example_1":{"value":{"status":"completed","extracted":{"airports":[]}}}}}}}},"parameters":[{"name":"query","in":"query","description":"Search term (e.g. 'London').","required":true,"schema":{"type":"string","example":"London"}},{"name":"limit","in":"query","description":"Maximum number of results to return.","required":false,"schema":{"type":"number","example":10,"default":10}}]}},"/explore":{"get":{"operationId":"get_explore","summary":"/explore","description":"Explore cheapest destinations from a given origin airport.","tags":["explore"],"responses":{"200":{"description":"Successful execution","content":{"application/json":{"schema":{"type":"object"},"examples":{"Example_1":{"value":{"status":"ok","origin":"JFK","depart_date":"2026-06-15","results":[{"destination":"MIA","price":99,"currency":"USD","airline":"American Airlines","departure_at":"2026-06-15T08:00:00","stops":0,"deep_link":"https://skiplagged.com/..."}]}}}}}}},"parameters":[{"name":"providers","in":"query","description":"Comma-separated list of providers to search.","required":false,"schema":{"type":"string"}},{"name":"origin","in":"query","description":"Origin airport IATA code (e.g. 'JFK').","required":true,"schema":{"type":"string","example":"JFK"}},{"name":"depart_date","in":"query","description":"Departure date (YYYY-MM-DD).","required":true,"schema":{"type":"string","example":"2026-06-15"}}]}},"/health_check":{"get":{"operationId":"get_health_check","summary":"/health_check","description":"Verify flight search service status and retrieve timestamp.","tags":["health_check"],"responses":{"200":{"description":"Successful execution","content":{"application/json":{"schema":{"type":"object"},"examples":{"Example_1":{"value":{"status":"completed","extracted":{"health":{"status":"healthy","timestamp":1779790000}}}}}}}}}}},"/calendar":{"get":{"operationId":"get_calendar","summary":"/calendar","description":"Cheapest flight price calendar grid for a given month range.","tags":["calendar"],"responses":{"200":{"description":"Successful execution","content":{"application/json":{"schema":{"type":"object"},"examples":{"Example_1":{"value":{"status":"ok","origin":"JFK","destination":"LAX","month":"2026-06","grid":{"2026-06-01":{"price":180,"currency":"USD","airline":"Delta Air Lines","stops":0,"deep_link":"https://..."}}}}}}}}},"parameters":[{"name":"destination","in":"query","description":"Destination airport IATA code (e.g. 'LAX').","required":true,"schema":{"type":"string","example":"LAX"}},{"name":"origin","in":"query","description":"Origin airport IATA code (e.g. 'JFK').","required":true,"schema":{"type":"string","example":"JFK"}},{"name":"month","in":"query","description":"Target month in YYYY-MM format (e.g. '2026-06').","required":true,"schema":{"type":"string","example":"2026-06"}},{"name":"providers","in":"query","description":"Comma-separated list of providers to search.","required":false,"schema":{"type":"string","example":"kiwi","default":"kiwi"}}]}},"/trends":{"get":{"operationId":"get_trends","summary":"/trends","description":"Retrieve historical flight pricing trends, averages, and BUY/WAIT recommendations.","tags":["trends"],"responses":{"200":{"description":"Successful execution","content":{"application/json":{"schema":{"type":"object"},"examples":{"Example_1":{"value":{"status":"success","origin":"JFK","destination":"LAX","current_price":250,"average_price":275.5,"min_price":210,"max_price":310,"price_diff_pct":-9.26,"recommendation":"BUY","reason":"Current price is below the historical average. Great time to book!","history":[]}}}}}}},"parameters":[{"name":"origin","in":"query","description":"Origin airport IATA code (e.g. 'JFK').","required":true,"schema":{"type":"string","example":"JFK"}},{"name":"destination","in":"query","description":"Destination airport IATA code (e.g. 'LAX').","required":true,"schema":{"type":"string","example":"LAX"}}]}},"/search_flights":{"get":{"operationId":"get_search_flights","summary":"/search_flights","description":"Search flights across multiple providers (Skyscanner, Jetcost, Skiplagged, Kiwi, Trip.com).","tags":["search_flights"],"responses":{"200":{"description":"Successful execution","content":{"application/json":{"schema":{"type":"object"},"examples":{"Example_1":{"summary":"Example_1","value":{"status":"completed","extracted":{"flights":[]}}}}}}}},"parameters":[{"name":"infants","in":"query","description":"Number of infant passengers.","required":false,"schema":{"type":"number","example":0,"default":0}},{"name":"providers","in":"query","description":"Comma-separated list of providers to search (e.g. 'kiwi,trip').","required":false,"schema":{"type":"string"}},{"name":"children","in":"query","description":"Number of child passengers.","required":false,"schema":{"type":"number","example":0,"default":0}},{"name":"destination","in":"query","description":"Destination airport IATA code (e.g. 'DXB').","required":true,"schema":{"type":"string","example":"DXB"}},{"name":"max_stops","in":"query","description":"Maximum number of stops/layovers.","required":false,"schema":{"type":"number"}},{"name":"return_date","in":"query","description":"Optional return date (YYYY-MM-DD).","required":false,"schema":{"type":"string"}},{"name":"direct_only","in":"query","description":"Filter results to show only direct flights (0 stops).","required":false,"schema":{"type":"boolean","example":false,"default":false}},{"name":"depart_date","in":"query","description":"Departure date (YYYY-MM-DD).","required":true,"schema":{"type":"string","example":"2026-09-15"}},{"name":"cabin_class","in":"query","description":"Cabin class filter (e.g. 'COACH', 'BUSINESS').","required":false,"schema":{"type":"string"}},{"name":"adults","in":"query","description":"Number of adult passengers.","required":false,"schema":{"type":"number","example":1,"default":1}},{"name":"origin","in":"query","description":"Origin airport IATA code (e.g. 'LHR').","required":true,"schema":{"type":"string","example":"LHR"}},{"name":"currency","in":"query","description":"Three-letter currency code (e.g. 'USD').","required":false,"schema":{"type":"string","example":"USD","default":"USD"}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}