{"uid":"cap_t-XU52xmWgI1HlFS-2RwK","slug":"munition-flight-search-b5e3a1f5","name":"Munition Flight Search","description":"Munition Flight Search: x402-paid live flight offer search for AI agents. Pay 0.05 USDC to search Duffel flight offers and receive compact normalized itineraries, prices, carriers, and metadata suitable for replay and downstream planning.","url":"https://api.munition.io/v1/flights/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"adults":{"type":"integer","default":1,"maximum":9,"minimum":1},"origin":{"type":"string","maxLength":3,"minLength":3,"description":"IATA airport code to depart from, for example SFO."},"infants":{"type":"integer","default":0,"maximum":9,"minimum":0},"nonStop":{"type":"boolean","description":"When true, return only offers whose itineraries have one segment each."},"children":{"type":"integer","default":0,"maximum":9,"minimum":0},"currency":{"type":"string","maxLength":3,"minLength":3,"description":"Optional ISO currency code used with maxPrice."},"maxPrice":{"type":"number","description":"Optional max total offer price. Currency conversion is not applied.","exclusiveMinimum":0},"maxResults":{"type":"integer","default":50,"maximum":50,"minimum":1},"returnDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Optional return date in YYYY-MM-DD format."},"destination":{"type":"string","maxLength":3,"minLength":3,"description":"IATA airport code to arrive at, for example NRT."},"travelClass":{"enum":["ECONOMY","PREMIUM_ECONOMY","BUSINESS","FIRST"],"type":"string","default":"ECONOMY"},"departureDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Outbound date in YYYY-MM-DD format."}}},"responseSchema":{"type":"json","example":{"meta":{"searchedAt":"2026-05-19T00:00:00.000Z","resultCount":1},"results":[{"id":"off_example","source":"flight_search","currency":"USD","totalPrice":"418.90","itineraries":[{"duration":"PT10H15M","segments":[{"arrival":{"at":"2026-08-11T15:00:00","airportCode":"NRT"},"departure":{"at":"2026-08-10T12:00:00","airportCode":"SFO"},"carrierCode":"BA","flightNumber":"284"}],"numberOfStops":0}],"airlineCodes":["BA"]}]}},"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_G9JKEmgJS0OboM-CGrQog","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":"Searches for available flight offers between two airports by date, passenger count, and cabin class, returning priced itineraries.","exampleAgentPrompt":"Search for round-trip economy flights from SFO to NRT departing August 10 and returning August 20, for 2 adults — non-stop only, max price $600 per person.","exampleUseCases":null,"resultDescription":"Returns a list of flight offers, each with a unique offer ID, total price in the requested currency, full itinerary breakdown including per-segment departure and arrival times, airport codes, carrier codes, flight numbers, and number of stops, plus metadata indicating how many results were found and when the search was performed.","failureModes":["Invalid IATA code (3-letter code doesn't match a known airport) returns a validation error","No flights found for the given route and date returns empty results array","maxPrice too low for any available flight returns empty results","departureDate in the past or malformed date string returns a 400 error","Payment failure via x402 returns 402 Payment Required","Rate limiting or provider outage returns 5xx error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to discover and compare available flight options between two airports on specific dates, especially in agentic workflows where no pre-existing API key or airline account is needed. Ideal for anonymous, pay-per-call flight lookups via x402 micropayments without OAuth or subscription setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:41:07.023Z","isFirstParty":false}