# Country and Currency Codes

ISO 3166 countries, ISO 4217 currencies, ISO 639 languages, calling codes and TLDs as an offline reference.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://country-codes-iso.x402tookit.com/openapi.json
- x402 manifest: https://country-codes-iso.x402tookit.com/.well-known/x402
- Catalog (free): https://country-codes-iso.x402tookit.com/catalog
- Health (free): https://country-codes-iso.x402tookit.com/health
- Uptime (free): https://country-codes-iso.x402tookit.com/uptime

## Endpoints (10)

### GET /calling-code — $0.02
Country for an ITU E.164 calling code or international number prefix, such as +44 or +1 876; flags shared codes.
Params: code: string
Example: https://country-codes-iso.x402tookit.com/calling-code?code=%2B1+876

### GET /code-convert — $0.02
Convert an ISO 3166-1 country code between alpha-2, alpha-3 and numeric; also name, currency, ccTLD, calling code.
Params: code: string, to?: string
Example: https://country-codes-iso.x402tookit.com/code-convert?code=USA&to=all

### GET /code-lookup — $0.02
Look up a country, currency or language from any ISO code, TLD or name, with fuzzy matching and ambiguity flags.
Params: q: string, type?: string
Example: https://country-codes-iso.x402tookit.com/code-lookup?q=Germny

### GET /code-validate — $0.02
Validate an ISO 3166-1, 4217 or 639 code or a ccTLD or dial code: assigned, reserved, deleted or unknown.
Params: code: string, kind: string
Example: https://country-codes-iso.x402tookit.com/code-validate?code=UK&kind=country-alpha2

### GET /country-currency — $0.02
Currency of a country (code, number, minor units) or every country using a currency, by ISO 4217.
Params: q: string, mode?: string
Example: https://country-codes-iso.x402tookit.com/country-currency?q=EUR

### GET /country-languages — $0.02
Languages listed for a country with ISO 639-1 and 639-2 codes and names, from a country name or ISO code.
Params: country: string
Example: https://country-codes-iso.x402tookit.com/country-languages?country=Switzerland

### GET /currency-info — $0.02
ISO 4217 currency details by code, number or name: minor units, issuers, countries; optional exact rounding of an amount.
Params: q: string, amount?: string
Example: https://country-codes-iso.x402tookit.com/currency-info?q=JPY&amount=12.5

### GET /language-lookup — $0.02
Look up a language by ISO 639-1, 639-2 (B or T) code, BCP 47 tag or English name; returns all code forms.
Params: q: string
Example: https://country-codes-iso.x402tookit.com/language-lookup?q=fre

### GET /name-normalise — $0.02
Normalise country names like USA, U.S. or United States of America to ISO codes; up to 25 per call, with confidence.
Params: names: string
Example: https://country-codes-iso.x402tookit.com/name-normalise?names=USA%7CU.S.%7CUnited+States+of+America%7CDeutschland%7CIvory+Coast

### GET /us-state-code — $0.02
US state, DC and territory lookup by USPS postal code, name or FIPS number; returns all three plus the type.
Params: q: string
Example: https://country-codes-iso.x402tookit.com/us-state-code?q=Colorado

## Terms

Reference tables compiled from open datasets (retrieval date and sources in the lib header) and cross-checked against Wikidata and Unicode CLDR, provided as is. Codes change: ISO and ITU publish the authoritative lists and are not affiliated with this service. Fuzzy name matching is a convenience, not an identity verification. Not legal, financial or compliance advice; do not use alone for sanctions, customs or payment decisions.