Currency Code

GET/v0/currency

Validates a currency code against the ISO 4217 standard. Both the three-letter alphabetic code (e.g. PLN) and the three-digit numeric code (e.g. 985) are accepted. Leading zeros in numeric codes are optional. When valid, the response includes the canonical alpha code, numeric code, currency name, and the number of minor units (decimal places) defined by the standard.

Try it

Query Parameters

Parameter	Type	Required	Description
value	string	Yes	The currency code to validate. Accepted formats: `PLN` (alpha), `985` (numeric)

Example Requests

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/currency?value=PLN"

Response Fields

Field	Type	Description
valid	boolean	Whether the value is a recognised ISO 4217 currency code
format	string	Detected input format: `alpha` or `numeric`
code	string	ISO 4217 three-letter alphabetic code (e.g. `PLN`)
numericCode	string	ISO 4217 three-digit numeric code, zero-padded (e.g. `985`)
name	string	Official English currency name (e.g. `Polish Złoty`)
minorUnit	number \| null	Number of digits after the decimal separator (e.g. `2` for PLN, `0` for JPY). `null` for commodity codes such as XAU (Gold)

Example Response

{
  "valid": true,
  "format": "alpha",
  "code": "PLN",
  "numericCode": "985",
  "name": "Polish Złoty",
  "minorUnit": 2
}

GET/v0/currency/list

Returns the full list of ISO 4217 currency codes, including active currencies and special commodity codes (Gold, Silver, SDR, etc.).

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/currency/list"

Object Fields

Field	Type	Description
code	string	ISO 4217 three-letter alphabetic code
numericCode	string	ISO 4217 three-digit numeric code, zero-padded
name	string	Official English currency name
minorUnit	number \| null	Number of decimal places; `null` for commodity codes (XAU, XAG, etc.)

Example Response

[
  { "code": "AED", "numericCode": "784", "name": "UAE Dirham", "minorUnit": 2 },
  { "code": "AFN", "numericCode": "971", "name": "Afghan Afghani", "minorUnit": 2 },
  ...
  { "code": "ZWL", "numericCode": "932", "name": "Zimbabwean Dollar", "minorUnit": 2 }
]