{"uid":"cap_1oSTPvcemMKCy3SD43k1d","slug":"airports-reference-list-airports-by-country-or-region-16d670c8","name":"Airports Reference – List Airports by Country or Region","description":"List airports in a country or ISO region (like US-CO) filtered by size and scheduled service, with codes.","url":"https://airports-reference.x402tookit.com/airports-in?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":["country"],"properties":{"type":{"type":"string","description":"any (default), large, medium or small: that size or bigger"},"limit":{"type":"integer","description":"Results 1 to 100 (default 25)"},"region":{"type":"string","description":"Optional ISO 3166-2 region, e.g. US-CO"},"country":{"type":"string","description":"ISO country code or name, e.g. NZ or New Zealand"},"scheduled":{"type":"string","description":"true to list only airports with scheduled service"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"total":{"type":["null","number"]},"counts":{"type":["null","object"],"properties":{"large":{"type":["null","number"]},"small":{"type":["null","number"]},"medium":{"type":["null","number"]}}},"region":{},"source":{"type":["null","string"]},"country":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"airports":{"type":["array","null"],"items":{"type":"object","properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"iata":{"type":["null","string"]},"icao":{"type":["null","string"]},"name":{"type":["null","string"]},"type":{"type":["null","string"]},"ident":{"type":["null","string"]},"region":{"type":["null","string"]},"country":{"type":["null","string"]},"elevationM":{"type":["null","number"]},"regionName":{"type":["null","string"]},"countryName":{"type":["null","string"]},"elevationFt":{"type":["null","number"]},"municipality":{"type":["null","string"]},"scheduledService":{"type":["boolean","null"]}}}},"degraded":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"countryName":{"type":["null","string"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ocPUbXFA4tvVa85aXaMLi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a filtered list of airports in a given country or ISO region, including IATA/ICAO codes, size, location, and scheduled service status.","exampleAgentPrompt":"Can you list all large airports in Colorado that have scheduled service? I need their names and IATA codes.","exampleUseCases":[{"title":"Flight planning for a US state","prompt":"Show me all medium and large airports in Texas with scheduled airline service — I need their names, IATA codes, and locations."},{"title":"Country-wide airport inventory","prompt":"List up to 50 airports in New Zealand, including small ones, and tell me which have scheduled service."},{"title":"Regional aviation coverage check","prompt":"What airports are in the US-CO region? Filter to only those with scheduled service and give me their IATA and ICAO codes."}],"resultDescription":"A JSON object containing a list of airports matching the query, each with IATA code, ICAO code, name, type/size, latitude, longitude, elevation in feet and meters, municipality, region, country, and scheduled service flag. Also includes a summary count of large, medium, and small airports found and a total count.","failureModes":["Missing required 'country' parameter returns an error","Invalid ISO country code or region code returns empty results or an error","Limit out of range (not 1–100) may return default or error","No airports match the filters — returns empty airports array with count 0","Payment not fulfilled — x402 payment required error before data is returned"],"whenToPreferThis":"Use this endpoint when you need to enumerate or survey airports across an entire country or sub-national region, optionally filtered by size category or scheduled service. Prefer this over the single-airport lookup endpoint when the goal is discovery or inventory rather than looking up a known airport. Ideal for building dropdown lists, coverage maps, or routing tables.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:14:28.244Z","isFirstParty":false,"canonicalSlug":"airports-reference-list-airports-by-country-or-region-16d670c8"}