{"uid":"cap_ZyiOBfnRDGnDwP5vv4tZK","slug":"airlines-reference-airlines-by-country-36d0597b","name":"Airlines Reference – Airlines by Country","description":"List airlines of a country (name as OpenFlights spells it) with active filter and paging; 'list' gives country counts.","url":"https://airlines-reference.x402tookit.com/airlines-by-country?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":{"limit":{"type":"integer","description":"Results 1 to 100 (default 50)"},"active":{"type":"string","description":"Y active only (default), N inactive only, any"},"offset":{"type":"integer","description":"Skip this many results (default 0)"},"country":{"type":"string","description":"Country name like 'United States' or 'Japan', or 'list' for all country counts"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"offset":{"type":["null","number"]},"source":{"type":["null","string"]},"country":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"results":{"type":["array","null"],"items":{"type":"object","properties":{"iata":{"type":["null","string"]},"icao":{"type":["null","string"]},"name":{"type":["null","string"]},"alias":{"type":["null","string"]},"active":{"type":["boolean","null"]},"country":{"type":["null","string"]},"callsign":{"type":["null","string"]},"openflightsId":{"type":["null","number"]},"routesInSnapshot":{"type":["null","number"]}}}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"matching":{"type":["null","number"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"totalInCountry":{"type":["null","number"]}}}}}}},"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_ZpI_ZqHs7H-ec3UBvhKHG","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 paginated list of airlines registered in a given country (by OpenFlights name), with optional active/inactive filter, or a country-level summary count via 'list'.","exampleAgentPrompt":"Can you list the active airlines registered in Japan using the OpenFlights reference data? Show me up to 50 results.","exampleUseCases":[{"title":"Active carrier lookup for a country","prompt":"Give me all active airlines in the United States from the OpenFlights reference — show the first 100 if there are that many."},{"title":"Country airline count overview","prompt":"How many airlines does each country have in the OpenFlights database? I need a country-level summary to compare aviation industry size."},{"title":"Inactive airline research","prompt":"I'm researching defunct carriers — can you pull all inactive airlines registered in the United Kingdom from the OpenFlights data?"}],"resultDescription":"Returns a JSON object with a paginated array of airline records (name, IATA, ICAO, callsign, alias, active flag, OpenFlights ID, route count in snapshot), plus totalInCountry, matching count, offset, country echoed back, data source attribution, and an asOf timestamp. When country='list', returns per-country airline counts instead.","failureModes":["Missing required 'country' query parameter returns an error","Country name not matching OpenFlights spelling returns zero results","Offset beyond total results returns empty results array","Invalid 'active' filter value may return unexpected results","Data is a static snapshot (circa 2017), so recently founded or dissolved airlines may be missing"],"whenToPreferThis":"Use this endpoint when you need to enumerate or count airlines by country using OpenFlights reference data, with control over active/inactive filtering and pagination. Prefer this over the name-search sibling when you know the country and want a complete list rather than a keyword match. Choose the 'list' mode when you need a cross-country airline count summary.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:30:50.256Z","isFirstParty":false,"canonicalSlug":"airlines-reference-airlines-by-country-36d0597b"}