{"openapi":"3.1.0","info":{"title":"Currency Codes (ISO 4217) API","version":"1.0.0","description":"The ISO 4217 currency-code register as an API — not foreign-exchange rates, but the metadata a checkout or accounting system needs to handle money correctly. Each currency carries its 3-letter alphabetic code, 3-digit numeric code, official name, the number of minor units (decimal places, e.g. JPY 0, USD 2, BHD 3) and the list of countries that use it. Look a currency up by alphabetic or numeric code, find the currencies a country uses, search by name, or list the whole register. Bundled and served from memory — always fast, no key needed upstream.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/currencycodes-api","description":"oanor gateway"}],"tags":[{"name":"Lookup"},{"name":"Search"},{"name":"List"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/code":{"get":{"operationId":"get_v1_code","tags":["Lookup"],"summary":"Currency by alphabetic or numeric code","description":"","parameters":[{"name":"code","in":"query","required":false,"description":"Alphabetic ISO 4217 code","schema":{"type":"string"},"example":"USD"},{"name":"number","in":"query","required":false,"description":"Numeric ISO 4217 code","schema":{"type":"string"},"example":"840"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"currency":{"code":"USD","name":"US Dollar","active":true,"numeric":"840","countries":["AMERICAN SAMOA","BONAIRE, SINT EUSTATIUS AND SABA","BRITISH INDIAN OCEAN TERRITORY (THE)","ECUADOR","EL SALVADOR","GUAM","HAITI","MARSHALL ISLANDS (THE)","MICRONESIA (FEDERATED STATES OF)","NORTHERN MARIANA ISLANDS (THE)","PALAU","PANAMA","PUERTO RICO","TIMOR-LESTE","TURKS AND CAICOS ISLANDS (THE)","UNITED STATES MINOR OUTLYING ISLANDS (THE)","UNITED STATES OF AMERICA (THE)","VIRGIN ISLANDS (BRITISH)","VIRGIN ISLANDS (U.S.)"],"minor_unit":2}},"meta":{"timestamp":"2026-06-08T18:25:12.472Z","request_id":"50e1b683-d4bf-43d4-bef7-9f196c97ae62"},"status":"ok","message":"Currency retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/country":{"get":{"operationId":"get_v1_country","tags":["Lookup"],"summary":"Currencies used by a country","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"Country name","schema":{"type":"string"},"example":"Japan"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"country":"Japan","currencies":[{"code":"JPY","name":"Yen","active":true,"numeric":"392","countries":["JAPAN"],"minor_unit":0}]},"meta":{"timestamp":"2026-06-08T18:25:12.603Z","request_id":"aebd9f4f-0b87-4df6-bbaa-a655405e69b0"},"status":"ok","message":"Country currencies retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Search currencies by code, name or country","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search query (min 2 chars)","schema":{"type":"string"},"example":"dinar"},{"name":"limit","in":"query","required":false,"description":"Max results (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":17,"query":"dinar","total":17,"currencies":[{"code":"BAD","name":"Dinar","active":false,"numeric":"070","countries":[]},{"code":"BHD","name":"Bahraini Dinar","active":true,"numeric":"048","countries":["BAHRAIN"],"minor_unit":3},{"code":"CSD","name":"Serbian Dinar","active":false,"numeric":"891","countries":[]},{"code":"DZD","name":"Algerian Dinar","active":true,"numeric":"012","countries":["ALGERIA"],"minor_unit":2},{"code":"HRD","name":"Croatian Dinar","active":false,"numeric":"191","countries":[]},{"code":"IQD","name":"Iraqi Dinar","active":true,"numeric":"368","countries":["IRAQ"],"minor_unit":3},{"code":"JOD","name":"Jordanian Dinar","active":true,"numeric":"400","countries":["JORDAN"],"minor_unit":3},{"code":"KWD","name":"Kuwaiti Dinar","active":true,"numeric":"414","countries":["KUWAIT"],"minor_unit":3},{"code":"LYD","name":"Libyan Dinar","active":true,"numeric":"434","countries":["LIBYA"],"minor_unit":3},{"code":"RSD","name":"Serbian Dinar","active":true,"numeric":"941","countries":["SERBIA"],"minor_unit":2},{"code":"SDD","name":"Sudanese Dinar","active":false,"numeric":"736","countries":[]},{"code":"TND","name":"Tunisian Dinar","active":true,"numeric":"788","countries":["TUNISIA"],"minor_unit":3},{"code":"XAD","name":"Arab Accounting Dinar","active":true,"numeric":"396","countries":["ARAB MONETARY FUND"],"minor_unit":2},{"code":"YDD","name":"Yemeni Dinar","active":false,"numeric":"720","countries":[]},{"code":"YUD","name":"New Yugoslavian Dinar","active":false,"numeric":"890","countries":[]},{"code":"YUM","name":"New Dinar","active":false,"numeric":"891","countries":[]},{"code":"YUN","name":"Yugoslavian Dinar","active":false,"numeric":"890","countries":[]}]},"meta":{"timestamp":"2026-06-08T18:25:12.743Z","request_id":"9486c850-53d7-4804-8a6d-5139a4f32d6c"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["List"],"summary":"List all currencies","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size (1-500)","schema":{"type":"string"},"example":"50"},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"string"},"example":"0"},{"name":"active","in":"query","required":false,"description":"Filter out withdrawn currencies","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"total":178,"currencies":[{"code":"AED","name":"UAE Dirham","active":true,"numeric":"784","countries":["UNITED ARAB EMIRATES (THE)"],"minor_unit":2},{"code":"AFN","name":"Afghani","active":true,"numeric":"971","countries":["AFGHANISTAN"],"minor_unit":2},{"code":"ALL","name":"Lek","active":true,"numeric":"008","countries":["ALBANIA"],"minor_unit":2},{"code":"AMD","name":"Armenian Dram","active":true,"numeric":"051","countries":["ARMENIA"],"minor_unit":2},{"code":"AOA","name":"Kwanza","active":true,"numeric":"973","countries":["ANGOLA"],"minor_unit":2},{"code":"ARS","name":"Argentine Peso","active":true,"numeric":"032","countries":["ARGENTINA"],"minor_unit":2},{"code":"AUD","name":"Australian Dollar","active":true,"numeric":"036","countries":["AUSTRALIA","CHRISTMAS ISLAND","COCOS (KEELING) ISLANDS (THE)","HEARD ISLAND AND McDONALD ISLANDS","KIRIBATI","NAURU","NORFOLK ISLAND","TUVALU"],"minor_unit":2},{"code":"AWG","name":"Aruban Florin","active":true,"numeric":"533","countries":["ARUBA"],"minor_unit":2},{"code":"AZN","name":"Azerbaijan Manat","active":true,"numeric":"944","countries":["AZERBAIJAN"],"minor_unit":2},{"code":"BAM","name":"Convertible Mark","active":true,"numeric":"977","countries":["BOSNIA AND HERZEGOVINA"],"minor_unit":2},{"code":"BBD","name":"Barbados Dollar","active":true,"numeric":"052","countries":["BARBADOS"],"minor_unit":2},{"code":"BDT","name":"Taka","active":true,"numeric":"050","countries":["BANGLADESH"],"minor_unit":2},{"code":"BHD","name":"Bahraini Dinar","active":true,"numeric":"048","countries":["BAHRAIN"],"minor_unit":3},{"code":"BIF","name":"Burundi Franc","active":true,"numeric":"108","countries":["BURUNDI"],"minor_unit":0},{"code":"BMD","name":"Bermudian Dollar","active":true,"numeric":"060","countries":["BERMUDA"],"minor_unit":2},{"code":"BND","name":"Brunei Dollar","active":true,"numeric":"096","countries":["BRUNEI DARUSSALAM"],"minor_unit":2},{"code":"BOB","name":"Boliviano","active":true,"numeric":"068","countries":["BOLIVIA (PLURINATIONAL STATE OF)"],"minor_unit":2},{"code":"BOV","name":"Mvdol","active":true,"numeric":"984","countries":["BOLIVIA (PLURINATIONAL STATE OF)"],"minor_unit":2},{"code":"BRL","name":"Brazilian Real","active":true,"numeric":"986","countries":["BRAZIL"],"minor_unit":2},{"code":"BSD","name":"Bahamian Dollar","active":true,"numeric":"044","countries":["BAHAMAS (THE)"],"minor_unit":2},{"code":"BTN","name":"Ngultrum","active":true,"numeric":"064","countries":["BHUTAN"],"minor_unit":2},{"code":"BWP","name":"Pula","active":true,"numeric":"072","countries":["BOTSWANA"],"minor_unit":2},{"code":"BYN","name":"Belarusian Ruble","active":true,"numeric":"933","countries":["BELARUS"],"minor_unit":2},{"code":"BZD","name":"Belize Dollar","active":true,"numeric":"084","countries":["BELIZE"],"minor_unit":2},{"code":"CAD","name":"Canadian Dollar","active":true,"numeric":"124","countries":["CANADA"],"minor_unit":2},{"code":"CDF","name":"Congolese Franc","active":true,"numeric":"976","countries":["CONGO (THE DEMOCRATIC REPUBLIC OF THE)"],"minor_unit":2},{"code":"CHE","name":"WIR Euro","active":true,"numeric":"947","countries":["SWITZERLAND"],"minor_unit":2},{"code":"CHF","name":"Swiss Franc","active":true,"numeric":"756","countries":["LIECHTENSTEIN","SWITZERLAND"],"minor_unit":2},{"code":"CHW","name":"WIR Franc","active":true,"numeric":"948","countries":["SWITZERLAND"],"minor_unit":2},{"code":"CLF","name":"Unidad de Fomento","active":true,"numeric":"990","countries":["CHILE"],"minor_unit":4},{"code":"CLP","name":"Chilean Peso","active":true,"numeric":"152","countries":["CHILE"],"minor_unit":0},{"code":"CNY","name":"Yuan Renminbi","active":true,"numeric":"156","countries":["CHINA"],"minor_unit":2},{"code":"COP","name":"Colombian Peso","active":true,"numeric":"170","countries":["COLOMBIA"],"minor_unit":2},{"code":"COU","name":"Unidad de Valor Real","active":true,"numeric":"970","countries":["COLOMBIA"],"minor_unit":2},{"code":"CRC","name":"Costa Rican Colon","active":true,"numeric":"188","countries":["COSTA RICA"],"minor_unit":2},{"code":"CUP","name":"Cuban Peso","active":true,"numeric":"192","countries":["CUBA"],"minor_unit":2},{"code":"CVE","name":"Cabo Verde Escudo","active":true,"numeric":"132","countries":["CABO VERDE"],"minor_unit":2},{"code":"CZK","name":"Czech Koruna","active":true,"numeric":"203","countries":["CZECHIA"],"minor_unit":2},{"code":"DJF","name":"Djibouti Franc","active":true,"numeric":"262","countries":["DJIBOUTI"],"minor_unit":0},{"code":"DKK","name":"Danish Krone","active":true,"numeric":"208","countries":["DENMARK","FAROE ISLANDS (THE)","GREENLAND"],"minor_unit":2},{"code":"DOP","name":"Dominican Peso","active":true,"numeric":"214","countries":["DOMINICAN REPUBLIC (THE)"],"minor_unit":2},{"code":"DZD","name":"Algerian Dinar","active":true,"numeric":"012","countries":["ALGERIA"],"minor_unit":2},{"code":"EGP","name":"Egyptian Pound","active":true,"numeric":"818","countries":["EGYPT"],"minor_unit":2},{"code":"ERN","name":"Nakfa","active":true,"numeric":"232","countries":["ERITREA"],"minor_unit":2},{"code":"ETB","name":"Ethiopian Birr","active":true,"numeric":"230","countries":["ETHIOPIA"],"minor_unit":2},{"code":"EUR","name":"Euro","active":true,"numeric":"978","countries":["ÅLAND ISLANDS","ANDORRA","AUSTRIA","BELGIUM","BULGARIA","CROATIA","CYPRUS","ESTONIA","EUROPEAN UNION","FINLAND","FRANCE","FRENCH GUIANA","FRENCH SOUTHERN TERRITORIES (THE)","GERMANY","GREECE","GUADELOUPE","HOLY SEE (THE)","IRELAND","ITALY","LATVIA","LITHUANIA","LUXEMBOURG","MALTA","MARTINIQUE","MAYOTTE","MONACO","MONTENEGRO","NETHERLANDS (THE)","PORTUGAL","RÉUNION","SAINT BARTHÉLEMY","SAINT MARTIN (FRENCH PART)","SAINT PIERRE AND MIQUELON","SAN MARINO","SLOVAKIA","SLOVENIA","SPAIN"]},{"code":"FJD","name":"Fiji Dollar","active":true,"numeric":"242","countries":["FIJI"],"minor_unit":2},{"code":"FKP","name":"Falkland Islands Pound","active":true,"numeric":"238","countries":["FALKLAND ISLANDS (THE) [MALVINAS]"],"minor_unit":2},{"code":"GBP","name":"Pound Sterling","active":true,"numeric":"826","countries":["GUERNSEY","ISLE OF MAN","JERSEY","UNITED KINGDOM OF GREAT BRITAIN AND NORTHERN IRELAND (THE)"],"minor_unit":2},{"code":"GEL","name":"Lari","active":true,"numeric":"981","countries":["GEORGIA"],"minor_unit":2}]},"meta":{"timestamp":"2026-06-08T18:25:12.856Z","request_id":"699be7cc-bf30-4dda-bd70-7a3071bc5235"},"status":"ok","message":"Currencies listed successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"currencycodes-api","endpoints":{"GET /v1/code":"Currency detail by alphabetic code (code=, e.g. USD) or numeric (number=, e.g. 840).","GET /v1/list":"List all currencies (limit, offset, active=true to filter out withdrawn).","GET /v1/meta":"This document.","GET /v1/search":"Search currencies by code, name or country (q=, min 2 chars).","GET /v1/country":"Currencies used by a country (country=, e.g. Japan)."},"description":"ISO 4217 currency-code register (no FX rates): 3-letter alphabetic code, 3-digit numeric code, official currency name, minor-unit decimal places and the countries using each currency. The metadata a checkout or accounting system needs to format and validate money. No key.","total_currencies":307,"active_currencies":178,"countries_indexed":261},"meta":{"timestamp":"2026-06-08T18:25:12.980Z","request_id":"6ba814c8-0dff-4f3a-9fbf-ea6b33325b7b"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":15000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":500,"monthly_call_quota":150000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1600,"monthly_call_quota":700000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4000,"monthly_call_quota":3000000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/currencycodes-api"}