# ISO 4217 Currency Lookup by Code

> ISO 4217 Currency Lookup by Code is a paid API for AI agents from iso.openverbs.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Look up a single active ISO 4217 currency by its alphabetic (e.g. EUR) or numeric (e.g. 978) code, returning its full name, codes, and minor unit count.

## Facts

- Endpoint: POST https://iso.openverbs.com/v1/currency
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/iso-4217-currency-lookup-by-code-4f4690e7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gdQOs8FGAi4x63ClLSV95

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 iso-4217-currency-lookup-by-code-4f4690e7 -d '<json body>'
```

Example prompt: What's the full ISO 4217 name and number of decimal places for the currency with alphabetic code KWD?

## When to prefer this

Choose this endpoint when you need precise, structured ISO 4217 currency metadata — especially the official name, numeric code, or minor unit count — for a specific currency code. It is ideal for payment validation, invoice generation, financial data enrichment, and internationalisation workflows where authoritative ISO standard data is required. Prefer this over general-purpose search or fuzzy-match endpoints when you already know the exact alphabetic or numeric code.

## Known failure modes

- Invalid or unrecognized alphabetic/numeric code returns an error or empty result
- Providing both code and numeric fields simultaneously may be rejected (only one field should be provided)
- Providing neither field returns a validation error
- Inactive or historical currency codes not in the active ISO 4217 registry return no result
- Malformed numeric codes (non-string or wrong format) may cause a validation error

## How this service works

Look up an active ISO 4217 currency by its alphabetic code or numeric code. Provide exactly one field. Returns the code, numeric code, name and number of minor units (decimal places).

## Output

Returns a JSON object containing the currency's ISO 4217 alphabetic code, numeric code, full English name, and the number of minor units (decimal places) used by that currency. Only active ISO 4217 currencies are returned.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {
      "code": {
       "type": "string",
       "description": "ISO 4217 alphabetic code, e.g. \"EUR\"."
      },
      "numeric": {
       "type": "string",
       "description": "ISO 4217 numeric code, e.g. \"978\"."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/iso-4217-currency-lookup-by-code-4f4690e7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from iso.openverbs.com](https://www.zero.xyz/host/iso.openverbs.com/llms.txt)