{"uid":"cap_Ky_fCisAmPz-9bEucsLNg","slug":"country-facts-filter-countries-by-region-currency-language-driving-f23dfea4","name":"Country Facts – Filter Countries by Region, Currency, Language, Driving Side, Landlocked, or UN Membership","description":"List countries by region, currency code, language, driving side, landlocked or UN membership; at least one filter.","url":"https://country-facts.x402tookit.com/countries-filter?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":{"limit":{"type":"integer","description":"Max countries returned, 1-250 (default 100)"},"region":{"type":"string","description":"Africa, Americas, Asia, Europe, Oceania or Antarctic"},"driving":{"type":"string","description":"left or right"},"currency":{"type":"string","description":"ISO 4217 code, e.g. EUR"},"language":{"type":"string","description":"Language name or ISO 639-3 code, e.g. Spanish or spa"},"unMember":{"type":"boolean","description":"true for UN member states"},"subregion":{"type":"string","description":"For example Western Europe or South-Eastern Asia"},"landlocked":{"type":"boolean","description":"true or false"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"shown":{"type":["null","number"]},"total":{"type":["null","number"]},"source":{"type":["null","string"]},"filters":{"type":["null","object"],"properties":{"region":{"type":["null","string"]},"driving":{"type":["null","string"]}}},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"countries":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":["null","string"]},"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"unMember":{"type":["boolean","null"]},"independent":{"type":["boolean","null"]}}}},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"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_nTSx7AHeYKX4FqPFX9Ph3","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 countries matching criteria such as region, currency code, language, driving side, landlocked status, or UN membership.","exampleAgentPrompt":"Can you list all landlocked countries in Africa that are UN members? Limit the results to 50.","exampleUseCases":[{"title":"Find left-hand traffic countries in Asia","prompt":"Which countries in Asia drive on the left side of the road? Show me up to 100 results."},{"title":"List Euro-using countries in Europe","prompt":"Can you find all countries in Europe that use the Euro as their currency?"},{"title":"Discover landlocked UN members in Americas","prompt":"List all landlocked countries in the Americas that are UN member states."}],"resultDescription":"Returns a JSON object containing a list of matching countries (with name, alpha2/alpha3 codes, UN membership, and independence status), total count, number shown, applied filters, a summary string, and metadata such as source and timestamp. May include a degraded flag and disclaimer if data quality is limited.","failureModes":["No filter provided — at least one query parameter is required; returns an error","Invalid region value (e.g. misspelled continent name) — may return empty results or validation error","Invalid ISO 4217 currency code — returns empty country list","Invalid language code or name — returns empty results","Limit out of range (below 1 or above 250) — may return error or default","Network or payment failure — 402 payment required if USDC payment not processed"],"whenToPreferThis":"Use this endpoint when you need to retrieve a filtered set of countries based on one or more categorical attributes — region, currency, language, driving side, landlocked status, or UN membership. It is ideal for building country selection dropdowns, generating geographic reports, powering travel planning tools, or enriching datasets that require country segmentation. Prefer this over a full country listing endpoint when you want server-side filtering rather than downloading all countries and filtering locally.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:15:03.249Z","isFirstParty":false,"canonicalSlug":"country-facts-filter-countries-by-region-currency-language-driving-f23dfea4"}