# Country and Currency Codes – Code Validator

> Country and Currency Codes – Code Validator is a paid API for AI agents from country-codes-iso.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-30).

Validates an ISO 3166-1, 4217, or 639 code (or a ccTLD or dial code) and returns its status: assigned, reserved, deleted, or unknown.

## Facts

- Endpoint: GET https://country-codes-iso.x402tookit.com/code-validate?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/country-and-currency-codes-code-validator-dea041d0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n2KqhAmaoIY7HZxjVclQM

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-and-currency-codes-code-validator-dea041d0
```

Example prompt: Can you check whether 'EUR' is a valid ISO 4217 currency code and tell me if it's currently assigned?

## When to prefer this

Use this endpoint when you need to definitively verify whether a specific code string conforms to a known ISO standard (3166-1, 4217, 639) or is a valid ccTLD or ITU calling code, especially when you already know the code type. Prefer it over fuzzy-lookup or conversion endpoints when you want a strict assigned/reserved/deleted/unknown verdict rather than a translation or enrichment.

## Known failure modes

- Missing required query parameters 'code' or 'kind' returns an error
- Invalid 'kind' enum value causes a validation error
- Ambiguous or malformed codes may return verdict 'unknown' rather than an error
- Service degradation may result in degraded:true with partial results
- Network or payment failure returns no response

## How this service works

Validate an ISO 3166-1, 4217 or 639 code or a ccTLD or dial code: assigned, reserved, deleted or unknown.

## Output

Returns a structured object with fields including: valid (boolean), verdict (e.g. 'assigned', 'reserved', 'deleted', 'unknown'), normalised code, summary description, note, source authority, reasons array explaining the outcome, asOf timestamp indicating data freshness, and optional disclaimer. Also indicates if the check was degraded or if some sub-checks were skipped.

## 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": [
      "code",
      "kind"
     ],
     "properties": {
      "code": {
       "type": "string",
       "description": "The code to check, e.g. GB, EUR, 840, fr, .uk, +44"
      },
      "kind": {
       "type": "string",
       "description": "One of: country-alpha2, country-alpha3, country-numeric, currency, currency-numeric, language-639-1, language-639-2, cctld, calling-code"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "code": {
       "type": [
        "null",
        "string"
       ]
      },
      "kind": {
       "type": [
        "null",
        "string"
       ]
      },
      "note": {
       "type": [
        "null",
        "string"
       ]
      },
      "valid": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ]
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "normalised": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "attribution": {
       "type": [
        "null",
        "string"
       ]
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/country-and-currency-codes-code-validator-dea041d0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from country-codes-iso.x402tookit.com](https://www.zero.xyz/host/country-codes-iso.x402tookit.com/llms.txt)