{"uid":"cap_DnSbXGcbdVyrBLHtp4MMm","slug":"flight-search-airfares-c35e2ed7","name":"Flight Search & Airfares","description":"**Flight Search & Airfares** on x402 Atlas — pay-per-call over the [x402 protocol](https://x402.org).\n\nPaid routes are billed per call in USDC on Base, Polygon, or Arbitrum, starting at $0.005; each operation states its exact price below. Request a route with no payment to receive the `402` challenge, then repeat it with an `X-PAYMENT` header — an x402 client (`x402-fetch` / `x402-axios`) performs that exchange for you.\n\nFull onboarding, quickstart, and the other APIs: https://use.x402atlas.com/docs","url":"https://flights.use.x402atlas.com/search/%7Bdeparture%7D/%7Barrival%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"currency":"USD","trip_type":"round_trip","arrival_id":"JFK","queried_at":"2026-07-28T10:00:00Z","return_date":"2026-08-18","best_flights":[{"type":"Round trip","price":612,"flights":[{"airline":"British Airways","duration":475,"travel_class":"Economy","flight_number":"EA 101","arrival_airport":{"id":"JFK","name":"John F. Kennedy International Airport","time":"2026-08-11 13:25"},"departure_airport":{"id":"LHR","name":"Heathrow Airport","time":"2026-08-11 10:30"}}],"total_duration":475,"departure_token":"opaque-return-selection-token","carbon_emissions":{"this_flight":410000,"difference_percent":-8,"typical_for_this_route":445000}}],"departure_id":"LHR","travel_class":"economy","other_flights":[],"outbound_date":"2026-08-11","price_insights":{"price_level":"typical","lowest_price":612,"typical_price_range":[540,760]}}},"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_m2ehXx3PnW5iMG_YxgsCB","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 and compare fares between two airports by departure and arrival IATA codes","exampleAgentPrompt":"Can you search for round-trip economy flights from LHR to JFK departing August 11 and returning August 18, and show me the best fares with airline details and carbon emissions?","exampleUseCases":[{"title":"Budget travel planning for a trip","prompt":"Find me the cheapest economy round-trip flights from LAX to CDG departing September 5 and coming back September 19 — I want to see all the options and what a typical price looks like for that route."},{"title":"Business trip flight comparison","prompt":"I need to fly from ORD to LHR for a work trip, leaving November 3 and returning November 7. Can you pull up available flights and compare the fares so I can pick the best option?"},{"title":"Eco-conscious flight selection","prompt":"Search for flights from SFO to NRT departing October 12 and show me the carbon emissions for each option — I want to pick the most environmentally friendly flight that's still reasonably priced."}],"resultDescription":"Returns a structured JSON object with the best matching flight itineraries including airline names, flight numbers, departure and arrival airports with times, total duration, travel class, ticket price in USD, carbon emissions data (this flight vs. typical), a departure token for return leg selection, and price insights including price level classification and typical price range for the route.","failureModes":["Invalid or unrecognized IATA airport codes return an error or empty results","No flights available for the requested route and dates returns empty best_flights array","Missing payment header triggers a 402 challenge response requiring X-PAYMENT header","Malformed date parameters may cause request rejection","Extremely obscure routes with no direct or connecting service return no results"],"whenToPreferThis":"Use this endpoint when you need real-time flight search with fare comparison across a specific city-pair route, especially when you want structured data including price insights, carbon emissions, and itinerary details. Prefer this over generic travel aggregator scraping when you need clean JSON output suitable for agent reasoning or downstream booking workflows, and when cost-per-call economics ($0.05 USDC) fit your usage pattern.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:30:01.838Z","isFirstParty":false}