{"uid":"cap_nGB7rTqqJn168FXTS6yti","slug":"airport-fuzzy-search-7c7b8c22","name":"Airport Fuzzy Search","description":"Fuzzy-search airports by name, city or code, optionally filtered by ISO country code or airport type. Matches are ranked exact-code/name then prefix then substring, larger airports first. Empty result is a successful 200.","url":"https://airport.openverbs.com/v1/search","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["query"],"properties":{"type":{"enum":["large","medium","small","seaplane_base","heliport","balloonport","closed"],"type":"string","description":"Optional airport-type filter."},"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum matches to return. Default 20."},"query":{"type":"string","minLength":1,"description":"Airport name, city or code fragment to search for."},"country":{"type":"string","description":"Optional ISO 3166-1 alpha-2 country filter, e.g. \"US\"."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GSJ0NRUGAX8rhkuFSJKRP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fuzzy-search airports by name, city, or code with ranked results, optionally filtered by country or airport type","exampleAgentPrompt":"Search for airports matching 'Heathrow' in the UK and return up to 5 results, large airports only.","exampleUseCases":[{"title":"Flight booking airport selection","prompt":"I need to find all large airports in Japan — can you search for airports with type 'large' and country 'JP' so I can pick which one to fly into?"},{"title":"Autocomplete for travel app","prompt":"The user typed 'frank' in the airport search box — find up to 10 airports matching that query so I can show them autocomplete suggestions."},{"title":"Heliport lookup for charter service","prompt":"Find heliports in the US matching 'Manhattan' — filter by type 'heliport' and country 'US', up to 20 results."}],"resultDescription":"A ranked list of airport objects matching the query, ordered by exact code/name match first, then prefix matches, then substring matches, with larger airports ranked above smaller ones. An empty result set is returned as a successful 200 response when no airports match.","failureModes":["Query too short or empty — minimum 1 character required","Invalid ISO country code returns no results or validation error","Invalid airport type enum value causes request rejection","Limit out of range (must be 1–100) causes validation error","No matching airports returns empty array with 200 status"],"whenToPreferThis":"Use this endpoint when you need to search for airports by partial name, city, or code fragment with fuzzy matching and ranking. Prefer this over the exact-code lookup endpoint when the user's input is incomplete or uncertain, and over the nearest-airport endpoint when the user has no coordinates but does have a name or code fragment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:34:20.028Z","isFirstParty":false}