{"uid":"cap_jQP7Ag8XgOInFHQzUhFgI","slug":"zeroclick-x402-service-registry-flight-search-cd3e3f02","name":"Flight Search (Google Flights via ZeroClick)","description":"Search flights between airports with real-time pricing from Google Flights. Input: origin/destination IATA codes, departure date, optional return date, stop preferences. Output: flight offers with prices, airlines, schedules, stops, and segment details. Supports one-way and round-trip searches.","url":"https://flights.withzero.ai/run?utm_source=zero.xyz","method":"POST","headers":{"X-ZAM-Access-Key":"zeroclick"},"bodySchema":{"type":"object","required":["origin","destination","departureDate"],"properties":{"stops":{"enum":["any","nonstop","1stop"],"type":"string","default":"any","description":"Stop preference (default: any)"},"adults":{"type":"integer","default":1,"maximum":9,"minimum":1,"description":"Number of adult passengers (default: 1)"},"origin":{"type":"string","maxLength":4,"minLength":3,"description":"Origin airport IATA code (e.g. \"LAX\")"},"maxResults":{"type":"integer","default":5,"maximum":20,"minimum":1,"description":"Maximum results to return (default: 5)"},"returnDate":{"type":"string","description":"Return date for round trip (YYYY-MM-DD). Omit for one-way."},"destination":{"type":"string","maxLength":4,"minLength":3,"description":"Destination airport IATA code (e.g. \"JFK\")"},"departureDate":{"type":"string","description":"Departure date (YYYY-MM-DD)"}},"additionalProperties":false},"responseSchema":{"type":"object","required":["origin","destination","departureDate","returnDate","resultCount","results"],"properties":{"origin":{"type":"string","description":"Origin airport"},"results":{"type":"array","items":{"type":"object","required":["airline","price","priceFormatted","duration","stops","departureTime","arrivalTime","segments","bookingLink"],"properties":{"price":{"type":"number","description":"Price in USD"},"stops":{"type":"number","description":"Number of stops (0 = direct)"},"airline":{"type":"string","description":"Primary airline"},"duration":{"type":"string","description":"Total duration (e.g. \"5h 30m\")"},"segments":{"type":"array","items":{"type":"object","required":["airline","flightNumber","departure","arrival","departureTime","arrivalTime","duration","airplane"],"properties":{"airline":{"type":"string","description":"Airline name"},"arrival":{"type":"string","description":"Arrival airport IATA code"},"airplane":{"type":"string","nullable":true,"description":"Aircraft type"},"duration":{"type":"string","description":"Segment duration (e.g. \"5h 30m\")"},"departure":{"type":"string","description":"Departure airport IATA code"},"arrivalTime":{"type":"string","description":"Arrival time"},"flightNumber":{"type":"string","description":"Flight number (e.g. \"DL 123\")"},"departureTime":{"type":"string","description":"Departure time"}},"additionalProperties":false},"description":"Flight segments"},"arrivalTime":{"type":"string","description":"Final arrival time"},"bookingLink":{"type":"string","nullable":true,"description":"Link to book (if available)"},"departureTime":{"type":"string","description":"First departure time"},"priceFormatted":{"type":"string","description":"Formatted price (e.g. \"$325\")"}},"additionalProperties":false},"description":"Flight offers"},"returnDate":{"type":"string","nullable":true,"description":"Return date (null if one-way)"},"destination":{"type":"string","description":"Destination airport"},"resultCount":{"type":"number","description":"Number of results returned"},"departureDate":{"type":"string","description":"Departure date"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["travel","flights","airline","search","booking"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":4,"rating":{"score":"0.52","successRate":"0.93","reviews":4,"stars":"3.1","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"5.0000","medianCents":"5.0000","p90Cents":"5.0000","minCents":"5.0000","maxCents":"5.0000","p95Cents":"5.0000","sampleCount":2,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_imn29uBs3KKFwPT2sf3Ku","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"flight-search:1"}],"brandName":"ZeroClick x402 Service Registry","brandSlug":"zeroclick-x402-service-registry","brandBaseUrl":"https://withzero.ai","brandDocsUrl":null,"whatItDoes":"Searches one-way or round-trip flights between two airports with real-time pricing and schedules sourced from Google Flights.","exampleAgentPrompt":"Search for round-trip flights from LAX to JFK for 1 adult, departing July 15 and returning July 22 — nonstop only, show me the top 5 options with prices and airlines.","exampleUseCases":null,"resultDescription":"Returns an array of flight offers, each with airline name, formatted price in USD, total duration, number of stops, departure and arrival times, a booking link, and full segment-level details (flight number, aircraft type, per-leg departure/arrival airports and times). Also echoes back origin, destination, departure date, return date, and result count.","failureModes":["Invalid IATA code returns an error or empty results","No flights available for the requested route/date returns an empty results array","Past or unparseable departure date causes a validation error","Exceeding maxResults limit of 20 returns an error","Network timeout from Google Flights upstream causes a 5xx response"],"whenToPreferThis":"Use this endpoint when you need real-time Google Flights pricing and schedule data for a specific route and date. Ideal for travel planning agents that need live fare comparisons, itinerary building, or helping users find the cheapest or most convenient flight options. Prefer this over static flight databases when freshness and actual booking prices matter.","instructions":null,"reviewSummary":"Flight search via Google Flights API delivers accurate fare, schedule, and airline data for near-term queries, with successful calls matching independent verification on flight numbers, times, and prices. However, the published schema contains documented errors — adults and maxResults must be numbers, not strings, and the stops parameter requires 'nonstop' rather than the enumerated string values shown — causing HTTP 400 rejections that are still billed. Far-future date queries (e.g., ~2 years out) may return 502 errors with no results, also while incurring charges.","reviewSummaryHighlights":["Accurate pricing and schedule data confirmed against independent Google Flights queries","Returns booking links alongside flight offers for one-way and round-trip searches"],"reviewSummaryConcerns":["Published schema incorrectly types adults, maxResults, and stops — rejected calls are still charged","Far-future date queries return 502 errors with no results, but charges still apply"],"reviewSummaryGeneratedAt":"2026-07-17T04:15:18.797Z","activationCount":75,"lastUsedAt":"2026-09-14T11:45:42.034Z","lastSuccessfullyRanAt":"2026-09-14T11:45:05.363Z","lastHealthCheckAt":"2026-10-11T04:29:42.865Z","isFirstParty":true,"canonicalSlug":"zeroclick-x402-service-registry-flight-search-cd3e3f02"}