{"uid":"cap_ioVcYwaV8CXDihif5GNid","slug":"flight-search-airfares-980eb512","name":"Flight Search & Airfares","description":"Flight search by departure and arrival airports in the URL — compare live itineraries, fares, schedules, stops and emissions across airlines, similar to Google Flights, as clean JSON.","url":"https://flights.use.x402atlas.com/search/:departure/:arrival","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","pathParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["departure","arrival"],"properties":{"arrival":{"type":"string","pattern":"^[A-Za-z]{3}(,[A-Za-z]{3}){0,4}$","description":"Arrival airport(s): one to five comma-separated IATA codes"},"departure":{"type":"string","pattern":"^[A-Za-z]{3}(,[A-Za-z]{3}){0,4}$","description":"Departure airport(s): one to five comma-separated IATA codes"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","departure_id","arrival_id","outbound_date","trip_type","travel_class","currency","best_flights","other_flights"],"properties":{"airports":{"type":"array","items":{"type":"object"}},"currency":{"type":"string"},"trip_type":{"enum":["round_trip","one_way"],"type":"string"},"arrival_id":{"type":"string"},"queried_at":{"type":"string","format":"date-time"},"return_date":{"type":"string","format":"date"},"best_flights":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"price":{"type":"number"},"flights":{"type":"array","items":{"type":"object","properties":{"airline":{"type":"string"},"legroom":{"type":"string"},"airplane":{"type":"string"},"duration":{"type":"integer","description":"Segment duration in minutes"},"overnight":{"type":"boolean"},"extensions":{"type":"array","items":{"type":"string"}},"airline_logo":{"type":"string"},"travel_class":{"type":"string"},"flight_number":{"type":"string"},"arrival_airport":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"time":{"type":"string","description":"Local date and time"}}},"departure_airport":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"time":{"type":"string","description":"Local date and time"}}},"often_delayed_by_over_30_min":{"type":"boolean"}}}},"layovers":{"type":"array","items":{"type":"object"}},"extensions":{"type":"array","items":{"type":"string"}},"airline_logo":{"type":"string"},"total_duration":{"type":"integer","description":"Total itinerary duration in minutes"},"departure_token":{"type":"string","description":"Pass back to retrieve return-flight choices"},"carbon_emissions":{"type":"object"}}}},"departure_id":{"type":"string"},"travel_class":{"type":"string"},"other_flights":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"price":{"type":"number"},"flights":{"type":"array","items":{"type":"object","properties":{"airline":{"type":"string"},"legroom":{"type":"string"},"airplane":{"type":"string"},"duration":{"type":"integer","description":"Segment duration in minutes"},"overnight":{"type":"boolean"},"extensions":{"type":"array","items":{"type":"string"}},"airline_logo":{"type":"string"},"travel_class":{"type":"string"},"flight_number":{"type":"string"},"arrival_airport":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"time":{"type":"string","description":"Local date and time"}}},"departure_airport":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"time":{"type":"string","description":"Local date and time"}}},"often_delayed_by_over_30_min":{"type":"boolean"}}}},"layovers":{"type":"array","items":{"type":"object"}},"extensions":{"type":"array","items":{"type":"string"}},"airline_logo":{"type":"string"},"total_duration":{"type":"integer","description":"Total itinerary duration in minutes"},"departure_token":{"type":"string","description":"Pass back to retrieve return-flight choices"},"carbon_emissions":{"type":"object"}}}},"outbound_date":{"type":"string","format":"date"},"price_insights":{"type":"object"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4HETOJAePuKPVVZ6o_umr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search live flight itineraries, fares, schedules, stops, and emissions between airports by IATA code, returning structured JSON comparable to Google Flights.","exampleAgentPrompt":"Can you search for available flights from JFK to LAX and show me the best itineraries, prices, airlines, and number of stops?","exampleUseCases":[{"title":"Business trip flight comparison","prompt":"Find me the best flights from SFO to JFK — show me prices, airlines, layovers, and flight duration so I can pick the most efficient option."},{"title":"International route planning","prompt":"Search for flights from LAX to LHR and compare the cheapest and best-rated itineraries including stops, travel class, and carbon emissions."},{"title":"Multi-city departure options","prompt":"What flights are available from either ORD or MDW to MIA? Show me fares and schedules so I can decide which departure airport works better."}],"resultDescription":"A JSON object containing a list of best and other available flight itineraries for the given route, each with airline name and logo, flight number, airplane type, departure and arrival times and airports, segment duration, number of stops, legroom, travel class, fare price, trip type, currency, and carbon emissions data. Results include both 'best_flights' (top recommended) and 'other_flights' arrays, plus airport metadata.","failureModes":["Invalid or unsupported IATA airport codes return an error or empty results","More than five IATA codes in departure or arrival parameter violates schema pattern","No flights available for the requested route returns empty flight arrays","Upstream data provider outage may result in stale or unavailable pricing","Malformed IATA codes (wrong length or non-alphabetic) are rejected by regex validation"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable flight search results (itineraries, prices, schedules, stops, emissions) for a given airport pair without scraping a travel website. It is ideal for agents automating travel planning, fare comparison, or itinerary generation where Google Flights-style data is needed as clean JSON. Prefer this over a generic web search when you need normalized, schema-consistent flight data ready for downstream processing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T11:43:51.253Z","isFirstParty":false}