# Country List (ISO 3166)

> Country List (ISO 3166) is a paid API for AI agents from api.gadgethumans.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-17).

Returns ISO 3166 country records including alpha-2, alpha-3, numeric code, and region, optionally filtered by name or code query string.

## Facts

- Endpoint: GET https://api.gadgethumans.com/country-list?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/country-list-iso-3166-f7f339ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_djRjoRW6qvcbOLUFEh0RV

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-list-iso-3166-f7f339ea
```

Example prompt: Can you give me a list of all countries matching 'united' along with their ISO alpha-2, alpha-3, and numeric codes — limit it to 10 results?

## When to prefer this

Use this endpoint when you need fast, authoritative ISO 3166 country reference data — especially for populating country selectors, validating country codes, or enriching user-submitted data with standardized codes and regions. It is a pure CPU lookup with no latency, making it ideal for real-time form validation or data normalization pipelines.

## Known failure modes

- Missing required 'q' parameter returns a validation error
- Query matching zero countries returns an empty array
- Non-integer value for limit parameter may return a parse error
- Very broad queries may return large unfiltered result sets if limit is not set

## How this service works

Return ISO 3166 countries with alpha-2, alpha-3, numeric code and region, filterable by query. Pure CPU, instant.

## Output

A JSON array of matching country objects, each containing the country's full name, ISO alpha-2 code (e.g. 'DE'), alpha-3 code (e.g. 'DEU'), numeric code (e.g. 276), and world region (e.g. 'Europe'). Results are filtered by the query string if provided, and limited to the specified count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Filter by name or code"
      },
      "limit": {
       "type": "integer",
       "description": "Max results"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "ok": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/country-list-iso-3166-f7f339ea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gadgethumans.com](https://www.zero.xyz/host/api.gadgethumans.com/llms.txt)
