# Country Facts – Filter Countries by Region, Currency, Language, Driving Side, Landlocked, or UN Membership

> Country Facts – Filter Countries by Region, Currency, Language, Driving Side, Landlocked, or UN Membership is a paid API for AI agents from country-facts.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Returns a filtered list of countries matching criteria such as region, currency code, language, driving side, landlocked status, or UN membership.

## Facts

- Endpoint: GET https://country-facts.x402tookit.com/countries-filter?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/country-facts-filter-countries-by-region-currency-language-driving-f23dfea4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ky_fCisAmPz-9bEucsLNg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability country-facts-filter-countries-by-region-currency-language-driving-f23dfea4
```

Example prompt: Can you list all landlocked countries in Africa that are UN members? Limit the results to 50.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

List countries by region, currency code, language, driving side, landlocked or UN membership; at least one filter.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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",
        "st
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/country-facts-filter-countries-by-region-currency-language-driving-f23dfea4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from country-facts.x402tookit.com](https://www.zero.xyz/host/country-facts.x402tookit.com/llms.txt)