{"uid":"cap_gdQOs8FGAi4x63ClLSV95","slug":"iso-4217-currency-lookup-by-code-4f4690e7","name":"ISO 4217 Currency Lookup by Code","description":"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).","url":"https://iso.openverbs.com/v1/currency","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jlRgcDi9CWp6TAkyAH4h8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"What's the full ISO 4217 name and number of decimal places for the currency with alphabetic code KWD?","exampleUseCases":[{"title":"Validating currency code in checkout","prompt":"Before I process this payment, can you confirm that 'SEK' is a valid active ISO 4217 currency and tell me how many decimal places it uses?"},{"title":"Decoding numeric currency code from bank data","prompt":"I've got a bank file that references currency numeric code 392 — what currency is that and what's its alphabetic code?"},{"title":"Enriching invoice with full currency name","prompt":"I'm generating an invoice and I only have the currency code 'AED' — can you look up the full currency name and minor units so I can display them properly?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:31:39.057Z","isFirstParty":false}