{"uid":"cap_B7xrxVZe0dmviWy50qW-f","slug":"airport-nearest-search-by-coordinates-893edd8c","name":"Airport Nearest Search by Coordinates","description":"Find the airports nearest to a latitude/longitude, ordered by great-circle distance. Optionally cap the search radius (km), result count and airport type. Returns each airport with its distance in km.","url":"https://airport.openverbs.com/v1/nearest","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":["lat","lon"],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude in decimal degrees."},"lon":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude in decimal degrees."},"type":{"enum":["large","medium","small","seaplane_base","heliport","balloonport","closed"],"type":"string","description":"Optional airport-type filter."},"limit":{"type":"integer","maximum":50,"minimum":1,"description":"Maximum airports to return. Default 5."},"radiusKm":{"type":"number","description":"Search radius in km (default 500, max 20000)."}},"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.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LGCzshpS5tUmfs7obxEsq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finds airports nearest to a given latitude/longitude, ordered by great-circle distance, with optional filters for radius, result count, and airport type.","exampleAgentPrompt":"Find me the 5 nearest large airports within 300km of latitude 48.8566, longitude 2.3522 — ordered by distance.","exampleUseCases":[{"title":"Flight planning from a remote location","prompt":"I'm at coordinates 36.1699 latitude, -115.1398 longitude in Nevada. What are the 3 closest airports within 150km, any type?"},{"title":"Aviation emergency routing","prompt":"I need to find the nearest large or medium airport to latitude 51.5074, longitude -0.1278 — return up to 5 results within 500km."},{"title":"Heliport discovery near event venue","prompt":"Can you find all heliports within 50km of latitude 40.7128, longitude -74.0060 in New York, up to 10 results?"}],"resultDescription":"Returns a list of airports ordered by great-circle distance from the provided coordinates. Each airport entry includes its name, IATA/ICAO code, airport type, and distance in km from the query point. Results are capped by the requested limit (default 5) and search radius (default 500km).","failureModes":["Missing required lat or lon fields returns a validation error","Latitude outside -90 to 90 or longitude outside -180 to 180 returns a schema error","Invalid airport type enum value returns a validation error","limit out of range (< 1 or > 50) returns a validation error","No airports found within the specified radius returns an empty results list","Network timeout or service unavailability returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you have a geographic coordinate (lat/lon) and need to discover nearby airports ranked by proximity. Prefer this over fuzzy-name search when you know the location but not the airport name, or when building routing, logistics, or travel applications that need the geographically closest options. Choose the radius and type filters to narrow results for specialized use cases like finding only large commercial airports or heliports.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:30:22.904Z","isFirstParty":false}