{"uid":"cap_mX1b5khcag-MoVA3PC7qY","slug":"2s-airport-near-nearby-airport-lookup-by-coordinates-71c67189","name":"2s Airport Near — Nearby Airport Lookup by Coordinates","description":"Airports within a radius of a coordinate, sorted by distance. Query: lat (-90..90), lon (-180..180), radius_km (1-2000, default 200), limit (1-100, default 20), type (optional: large_airport|medium_airport|small_airport|heliport|seaplane_base|balloonport|closed), country (optional 2-letter ISO 3166-1), scheduled_service (optional bool, true = commercial-service airports only). Returns { query, count, airports: [{ id, ident, name, iataCode, icaoCode, type, latitude, longitude, distanceKm, ... }] }.","url":"https://2s.io/api/airport/near","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude in decimal degrees (-90 to 90)."},"lon":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude in decimal degrees (-180 to 180)."},"type":{"enum":["large_airport","medium_airport","small_airport","heliport","seaplane_base","balloonport","closed"],"type":"string","description":"Filter by airport type."},"limit":{"type":"integer","default":20,"maximum":100,"minimum":1,"description":"Max airports to return (1-100). Default 20."},"country":{"type":"string","description":"Filter by ISO 3166-1 alpha-2 country code (e.g. US)."},"radius_km":{"type":"number","default":200,"maximum":2000,"minimum":1,"description":"Search radius in kilometers (1-2000). Default 200."},"scheduled_service":{"type":"boolean","description":"When true, only commercial-service airports."}},"additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"lat":40.7128,"lon":-74.006,"limit":10,"radius_km":100}}},"response":{"data":{"ok":true,"meta":{"query":{"type":null,"limit":10,"country":null,"latitude":40.7128,"radiusKm":100,"longitude":-74.006,"scheduledServiceOnly":null}},"items":[{"id":23173,"name":"One Police Plaza Heliport","type":"heliport","ident":"NK39","gpsCode":"NK39","iataCode":null,"icaoCode":null,"latitude":40.7122,"continent":"NA","isoRegion":"US-NY","localCode":"NK39","longitude":-74.0017,"distanceKm":0.37,"isoCountry":"US","elevationFt":244,"municipality":"New York","wikipediaLink":null,"scheduledService":false},{"id":18257,"name":"Downtown Manhattan Heliport","type":"heliport","ident":"JRB","gpsCode":"KJRB","iataCode":"JRB","icaoCode":null,"latitude":40.7007,"continent":"NA","isoRegion":"US-NY","localCode":"JRB","longitude":-74.0086,"distanceKm":1.36,"isoCountry":"US","elevationFt":7,"municipality":"New York","wikipediaLink":"https://en.wikipedia.org/wiki/Downtown_Manhattan_Heliport","scheduledService":false},{"id":6839,"name":"Paulus Hook Pier Heliport","type":"heliport","ident":"05NJ","gpsCode":"05NJ","iataCode":null,"icaoCode":null,"latitude":40.7134,"continent":"NA","isoRegion":"US-NJ","localCode":"05NJ","longitude":-74.032,"distanceKm":2.19,"isoCountry":"US","elevationFt":7,"municipality":"Jersey City","wikipediaLink":null,"scheduledService":false},{"id":15321,"name":"Newport Helistop","type":"heliport","ident":"91NJ","gpsCode":"91NJ","iataCode":null,"icaoCode":null,"latitude":40.7244,"continent":"NA","isoRegion":"US-NJ","localCode":"91NJ","longitude":-74.0297,"distanceKm":2.38,"isoCountry":"US","elevationFt":6,"municipality":"Jersey City","wikipediaLink":null,"scheduledService":false},{"id":38682,"name":"Governor's Island Army Airfield","type":"closed","ident":"US-0002","gpsCode":null,"iataCode":null,"icaoCode":null,"latitude":40.6871,"continent":"NA","isoRegion":"US-NY","localCode":null,"longitude":-74.0221,"distanceKm":3.16,"isoCountry":"US","elevationFt":0,"municipality":"Governor's Island","wikipediaLink":null,"scheduledService":false},{"id":13407,"name":"New York Skyports Inc Seaplane Base","type":"seaplane_base","ident":"6N7","gpsCode":null,"iataCode":"NYS","icaoCode":null,"latitude":40.7351,"continent":"NA","isoRegion":"US-NY","localCode":"6N7","longitude":-73.9728,"distanceKm":3.74,"isoCountry":"US","elevationFt":0,"municipality":"New York","wikipediaLink":"https://en.wikipedia.org/wiki/New_York_Skyports_Inc._Seaplane_Base","scheduledService":true},{"id":13405,"name":"East 34th Street Heliport","type":"heliport","ident":"6N5","gpsCode":"6N5","iataCode":"TSS","icaoCode":null,"latitude":40.7424,"continent":"NA","isoRegion":"US-NY","localCode":"6N5","longitude":-73.9721,"distanceKm":4.36,"isoCountry":"US","elevationFt":10,"municipality":"New York","wikipediaLink":"https://en.wikipedia.org/wiki/East_34th_Street_Heliport","scheduledService":true},{"id":13942,"name":"Liberty State Park Heliport","type":"heliport","ident":"77NJ","gpsCode":"77NJ","iataCode":null,"icaoCode":null,"latitude":40.6932,"continent":"NA","isoRegion":"US-NJ","localCode":"77NJ","longitude":-74.0537,"distanceKm":4.57,"isoCountry":"US","elevationFt":3,"municipality":"Jersey City","wikipediaLink":null,"scheduledService":false},{"id":18256,"name":"West 30th Street Heliport","type":"heliport","ident":"JRA","gpsCode":"KJRA","iataCode":"JRA","icaoCode":null,"latitude":40.7551,"continent":"NA","isoRegion":"US-NY","localCode":"JRA","longitude":-74.0069,"distanceKm":4.7,"isoCountry":"US","elevationFt":7,"municipality":"New York","wikipediaLink":"https://en.wikipedia.org/wiki/West_30th_Street_Heliport","scheduledService":true},{"id":313333,"name":"Pan Am Building Heliport","type":"closed","ident":"US-12611","gpsCode":null,"iataCode":null,"icaoCode":null,"latitude":40.7533,"continent":"NA","isoRegion":"US-NY","localCode":null,"longitude":-73.9765,"distanceKm":5.14,"isoCountry":"US","elevationFt":870,"municipality":"New York","wikipediaLink":null,"scheduledService":false}],"total":null,"source":{"url":"https://ourairports.com","license":"CC0 (OurAirports)","provider":"OurAirports"}},"meta":{"cost":{"usd":0.001,"tier":0},"caller":"x402","version":null,"endpoint":"airport.near","settlement":{"txHash":"0x90ed4a4835d6f18e3fe398690299accb2426d1b9d4f896cf136e1093e1d16f02","network":"eip155:8453","success":true}}}},"exampleRequest":{"lat":40.7128,"lon":-74.006,"limit":10,"radius_km":100},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rRIL5zD7SnGgr17WdFPzH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked list of airports within a specified radius of a given lat/lon coordinate, with optional filters for airport type, country, and scheduled commercial service.","exampleAgentPrompt":"Find me all large airports with scheduled commercial service within 300 km of coordinates 48.8566° N, 2.3522° E — return up to 10 results.","exampleUseCases":null,"resultDescription":"A JSON array of airport objects sorted by distance, each including the airport's name, IATA code, ICAO code, type, municipality, ISO country, ISO region, scheduled service flag, and great-circle distance in km from the query point. Also includes the echoed query parameters and data source/license metadata.","failureModes":["Missing required lat or lon parameters returns a validation error","lat out of range (-90 to 90) or lon out of range (-180 to 180) returns a schema validation error","radius_km exceeding 2000 or below 1 returns an error","Invalid country code format (not 2-letter ISO) returns an error","No airports found within the specified radius returns an empty items array","Payment failure via x402 returns HTTP 402 before the query is executed"],"whenToPreferThis":"Use this endpoint when an agent needs to discover airports geographically near a point given as coordinates — especially useful for travel planning, logistics routing, aviation queries, or enriching location data with nearby aviation infrastructure. Prefer over flight-search APIs when the goal is airport discovery rather than flight booking or scheduling.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:52:09.588Z","isFirstParty":false}