{"uid":"cap_Oe1EDEX_Kq3lBSZyE81re","slug":"duo-data-utilities-airport-lookup-8ac8235e","name":"Duo Data Utilities – Airport Lookup","description":"Look up an airport by IATA or ICAO code and get its name, city, country, ISO 3166-2 region code, WGS-84 coordinates, elevation and IANA time zone, or find the nearest airports to a coordinate within a radius. Covers every airport worldwide that holds a three-letter IATA code and scheduled service. Returns the code type that matched and the distance in kilometres for proximity results.","url":"https://api.duoleads.com/v1/ref/airport?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"code":{"type":"string","maxLength":16,"description":"3-letter IATA or 4-letter ICAO code, case-insensitive."},"near":{"type":"string","maxLength":64,"description":"lat,lon to search around."},"limit":{"type":"string","default":"5","pattern":"^[+-]?\\d+$","maxLength":64,"description":"Maximum results 1-25, default 5. Only with near."},"country":{"type":"string","maxLength":16,"description":"ISO 3166-1 alpha-2 filter."},"radius_km":{"type":"string","default":"100","pattern":"^[+-]?(\\d+(\\.\\d*)?|\\.\\d+)([eE][+-]?\\d+)?$","maxLength":64,"description":"Search radius in km, 1-1000, default 100. Only with near."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","route","version","data","meta"],"properties":{"ok":{"const":true},"data":{"type":"object","required":["found"],"properties":{"found":{"type":"boolean"},"nearby":{"type":"array","items":{"type":"object","required":["iata","icao","name","municipality","country","region","lat","lon","elevation_ft","type","timezone","distance_km","bearing_deg"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"},"iata":{"type":"string"},"icao":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"},"timezone":{"type":"string"},"bearing_deg":{"type":"number"},"distance_km":{"type":"number"},"elevation_ft":{"type":["number","null"]},"municipality":{"type":"string"}}}},"airport":{"type":"object","required":["iata","icao","name","municipality","country","region","lat","lon","elevation_ft","type","timezone"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"},"iata":{"type":"string"},"icao":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"},"timezone":{"type":"string"},"elevation_ft":{"type":["number","null"]},"municipality":{"type":"string"}}},"matched_on":{"type":"string"}}},"meta":{"type":"object","required":["request_id","computed_at","price_usd","deterministic","disclaimer"],"properties":{"sources":{"type":"array","items":{"type":"object","required":["id","version","published"]}},"price_usd":{"type":"string"},"disclaimer":{"type":"string"},"request_id":{"type":"string"},"computed_at":{"type":"string","description":"RFC 3339 UTC with milliseconds"},"deterministic":{"type":"boolean"}}},"route":{"const":"/v1/ref/airport"},"version":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"found":true,"airport":{"lat":52.3086,"lon":4.76389,"iata":"AMS","icao":"EHAM","name":"Amsterdam Airport Schiphol","type":"large_airport","region":"NL-NH","country":"NL","timezone":"Europe/Amsterdam","elevation_ft":-11,"municipality":"Amsterdam"},"matched_on":"iata"},"meta":{"sources":[{"id":"ourairports","licence":"Public Domain","version":"2026-09-28 extract","published":"2026-09-28","attribution":"OurAirports (public domain)"},{"id":"timezone-boundary-builder","licence":"ODbL-1.0","version":"2026d","published":"2026-09-29","attribution":"Time zones derived from timezone-boundary-builder data (https://github.com/evansiroky/timezone-boundary-builder), (c) contributors, ODbL 1.0, via timezonefinder 9.0.0"}],"price_usd":"0.05","disclaimer":"Factual output of a deterministic computation over public data. Provided as is, with no warranty of accuracy, completeness or availability. Not investment, financial, legal, tax, medical or any other professional advice, and not a recommendation. Verify before relying on it. Terms: https://api.duoleads.com/terms","request_id":"01K6B7Q4ZC8H3F2M9WXR5TYN0D","computed_at":"2026-09-28T12:00:00.000Z","deterministic":true},"route":"/v1/ref/airport","version":"1.0.0"}},"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_LkSPYiRXjKPB4laoRV_i1","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":"Look up an airport by IATA or ICAO code, or find the nearest airports to a lat/lon coordinate within a configurable radius, returning name, location, region, elevation, and matched code type.","exampleAgentPrompt":"What's the full name, coordinates, and elevation of Amsterdam Airport — IATA code AMS?","exampleUseCases":[{"title":"Expand flight itinerary airport codes","prompt":"I have a flight itinerary with airport codes JFK, LHR, and DXB — can you look up the full name, city, and country for each of those airports?"},{"title":"Find nearest airports to a remote location","prompt":"What are the 5 closest airports to coordinates 51.5074, -0.1278 within 200 km, and how far away is each one?"},{"title":"Enrich airline route data with airport metadata","prompt":"I have an ICAO code YSSY from a flight record — can you get me the airport's full name, IATA code, region, and GPS coordinates?"}],"resultDescription":"A JSON object with a 'found' boolean and, if found, an 'airport' object containing IATA code, ICAO code, airport name, type, municipality, country (ISO 3166-1 alpha-2), region (ISO 3166-2), WGS-84 lat/lon, and elevation in feet. Also returns 'matched_on' indicating whether the match was on 'iata' or 'icao'. For proximity searches, results include distance in kilometres. Meta includes source attribution (OurAirports, public domain), request ID, timestamp, and price.","failureModes":["Invalid or unknown IATA/ICAO code returns found:false with no airport object","Malformed code (wrong length or format) may return a 400 error","Proximity search with no airports in radius returns an empty results array","radius_km outside 1-1000 range or limit outside 1-25 may return a validation error","Missing both 'code' and 'near' query parameters returns an error","Network or upstream service unavailability returns a 5xx error"],"whenToPreferThis":"Choose this endpoint when you need fast, deterministic airport reference data keyed by IATA or ICAO code, or when you need proximity-based airport discovery from a coordinate. It covers all airports worldwide with a three-letter IATA code and scheduled service. Prefer it over general geocoding APIs for aviation-specific metadata like elevation, ICAO codes, and ISO region codes. Not suitable when time zone data is needed alongside airport info, or when searching by airport name rather than code or coordinate.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:13.969Z","isFirstParty":false,"canonicalSlug":"duo-data-utilities-airport-lookup-8ac8235e"}