{"openapi":"3.1.0","info":{"title":"Localized Names API","version":"1.0.0","description":"Get the localized display name of a code in any language — countries and regions, languages, currencies, scripts and calendars. Pass a code, a type and a locale and the name endpoint returns the right name: US as region in fr gives \"États-Unis\", de as language in fr gives \"allemand\", EUR as currency gives \"Euro\", and the same code reads correctly in German, Japanese, Arabic or any other locale. The list endpoint returns every code of a type localized and sorted in that locale's collation — ideal for building a country, language or currency dropdown in any language. Powered by the platform's full ICU data (Intl.DisplayNames) and computed locally with no network calls. Built for internationalised forms and pickers, multilingual UIs, localized reports and onboarding. A localized-names resolver — distinct from country reference data in English (countries), number and currency formatting (numberformat) and locale date formatting (datelocale). No upstream key, no cache.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/displaynames-api","description":"oanor gateway"}],"tags":[{"name":"Localized Names"},{"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/list":{"get":{"operationId":"get_v1_list","tags":["Localized Names"],"summary":"All codes of a type, localized","description":"","parameters":[{"name":"type","in":"query","required":false,"description":"region, language, currency, calendar","schema":{"type":"string"},"example":"currency"},{"name":"locale","in":"query","required":false,"description":"BCP 47 locale","schema":{"type":"string"},"example":"en"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"currency","count":162,"items":[{"code":"AFN","name":"Afghan Afghani"},{"code":"ALL","name":"Albanian Lek"},{"code":"DZD","name":"Algerian Dinar"},{"code":"AOA","name":"Angolan Kwanza"},{"code":"ARS","name":"Argentine Peso"},{"code":"AMD","name":"Armenian Dram"},{"code":"AWG","name":"Aruban Florin"},{"code":"AUD","name":"Australian Dollar"},{"code":"AZN","name":"Azerbaijani Manat"},{"code":"BSD","name":"Bahamian Dollar"},{"code":"BHD","name":"Bahraini Dinar"},{"code":"BDT","name":"Bangladeshi Taka"},{"code":"BBD","name":"Barbadian Dollar"},{"code":"BYN","name":"Belarusian Ruble"},{"code":"BZD","name":"Belize Dollar"},{"code":"BMD","name":"Bermudan Dollar"},{"code":"BTN","name":"Bhutanese Ngultrum"},{"code":"BOB","name":"Bolivian Boliviano"},{"code":"BAM","name":"Bosnia-Herzegovina Convertible Mark"},{"code":"BWP","name":"Botswanan Pula"},{"code":"BRL","name":"Brazilian Real"},{"code":"GBP","name":"British Pound"},{"code":"BND","name":"Brunei Dollar"},{"code":"BGN","name":"Bulgarian Lev"},{"code":"BIF","name":"Burundian Franc"},{"code":"KHR","name":"Cambodian Riel"},{"code":"CAD","name":"Canadian Dollar"},{"code":"CVE","name":"Cape Verdean Escudo"},{"code":"XCG","name":"Caribbean guilder"},{"code":"KYD","name":"Cayman Islands Dollar"},{"code":"XAF","name":"Central African CFA Franc"},{"code":"XPF","name":"CFP Franc"},{"code":"CLP","name":"Chilean Peso"},{"code":"CNY","name":"Chinese Yuan"},{"code":"COP","name":"Colombian Peso"},{"code":"KMF","name":"Comorian Franc"},{"code":"CDF","name":"Congolese Franc"},{"code":"CRC","name":"Costa Rican Colón"},{"code":"HRK","name":"Croatian Kuna"},{"code":"CUC","name":"Cuban Convertible Peso"},{"code":"CUP","name":"Cuban Peso"},{"code":"CZK","name":"Czech Koruna"},{"code":"DKK","name":"Danish Krone"},{"code":"DJF","name":"Djiboutian Franc"},{"code":"DOP","name":"Dominican Peso"},{"code":"XCD","name":"East Caribbean Dollar"},{"code":"EGP","name":"Egyptian Pound"},{"code":"ERN","name":"Eritrean Nakfa"},{"code":"ETB","name":"Ethiopian Birr"},{"code":"EUR","name":"Euro"},{"code":"FKP","name":"Falkland Islands Pound"},{"code":"FJD","name":"Fijian Dollar"},{"code":"GMD","name":"Gambian Dalasi"},{"code":"GEL","name":"Georgian Lari"},{"code":"GHS","name":"Ghanaian Cedi"},{"code":"GIP","name":"Gibraltar Pound"},{"code":"GTQ","name":"Guatemalan Quetzal"},{"code":"GNF","name":"Guinean Franc"},{"code":"GYD","name":"Guyanaese Dollar"},{"code":"HTG","name":"Haitian Gourde"},{"code":"HNL","name":"Honduran Lempira"},{"code":"HKD","name":"Hong Kong Dollar"},{"code":"HUF","name":"Hungarian Forint"},{"code":"ISK","name":"Icelandic Króna"},{"code":"INR","name":"Indian Rupee"},{"code":"IDR","name":"Indonesian Rupiah"},{"code":"IRR","name":"Iranian Rial"},{"code":"IQD","name":"Iraqi Dinar"},{"code":"ILS","name":"Israeli New Shekel"},{"code":"JMD","name":"Jamaican Dollar"},{"code":"JPY","name":"Japanese Yen"},{"code":"JOD","name":"Jordanian Dinar"},{"code":"KZT","name":"Kazakhstani Tenge"},{"code":"KES","name":"Kenyan Shilling"},{"code":"KWD","name":"Kuwaiti Dinar"},{"code":"KGS","name":"Kyrgystani Som"},{"code":"LAK","name":"Laotian Kip"},{"code":"LBP","name":"Lebanese Pound"},{"code":"LSL","name":"Lesotho Loti"},{"code":"LRD","name":"Liberian Dollar"},{"code":"LYD","name":"Libyan Dinar"},{"code":"MOP","name":"Macanese Pataca"},{"code":"MKD","name":"Macedonian Denar"},{"code":"MGA","name":"Malagasy Ariary"},{"code":"MWK","name":"Malawian Kwacha"},{"code":"MYR","name":"Malaysian Ringgit"},{"code":"MVR","name":"Maldivian Rufiyaa"},{"code":"MRU","name":"Mauritanian Ouguiya"},{"code":"MUR","name":"Mauritian Rupee"},{"code":"MXN","name":"Mexican Peso"},{"code":"MDL","name":"Moldovan Leu"},{"code":"MNT","name":"Mongolian Tugrik"},{"code":"MAD","name":"Moroccan Dirham"},{"code":"MZN","name":"Mozambican Metical"},{"code":"MMK","name":"Myanmar Kyat"},{"code":"NAD","name":"Namibian Dollar"},{"code":"NPR","name":"Nepalese Rupee"},{"code":"ANG","name":"Netherlands Antillean Guilder"},{"code":"TWD","name":"New Taiwan Dollar"},{"code":"NZD","name":"New Zealand Dollar"},{"code":"NIO","name":"Nicaraguan Córdoba"},{"code":"NGN","name":"Nigerian Naira"},{"code":"KPW","name":"North Korean Won"},{"code":"NOK","name":"Norwegian Krone"},{"code":"OMR","name":"Omani Rial"},{"code":"PKR","name":"Pakistani Rupee"},{"code":"PAB","name":"Panamanian Balboa"},{"code":"PGK","name":"Papua New Guinean Kina"},{"code":"PYG","name":"Paraguayan Guarani"},{"code":"PEN","name":"Peruvian Sol"},{"code":"PHP","name":"Philippine Peso"},{"code":"PLN","name":"Polish Zloty"},{"code":"QAR","name":"Qatari Riyal"},{"code":"RON","name":"Romanian Leu"},{"code":"RUB","name":"Russian Ruble"},{"code":"RWF","name":"Rwandan Franc"},{"code":"SVC","name":"Salvadoran Colón"},{"code":"WST","name":"Samoan Tala"},{"code":"STN","name":"São Tomé & Príncipe Dobra"},{"code":"SAR","name":"Saudi Riyal"},{"code":"RSD","name":"Serbian Dinar"},{"code":"SCR","name":"Seychellois Rupee"},{"code":"SLE","name":"Sierra Leonean Leone"},{"code":"SLL","name":"Sierra Leonean Leone (1964—2022)"},{"code":"SGD","name":"Singapore Dollar"},{"code":"SBD","name":"Solomon Islands Dollar"},{"code":"SOS","name":"Somali Shilling"},{"code":"ZAR","name":"South African Rand"},{"code":"KRW","name":"South Korean Won"},{"code":"SSP","name":"South Sudanese Pound"},{"code":"XDR","name":"Special Drawing Rights"},{"code":"LKR","name":"Sri Lankan Rupee"},{"code":"SHP","name":"St. Helena Pound"},{"code":"XSU","name":"Sucre"},{"code":"SDG","name":"Sudanese Pound"},{"code":"SRD","name":"Surinamese Dollar"},{"code":"SZL","name":"Swazi Lilangeni"},{"code":"SEK","name":"Swedish Krona"},{"code":"CHF","name":"Swiss Franc"},{"code":"SYP","name":"Syrian Pound"},{"code":"TJS","name":"Tajikistani Somoni"},{"code":"TZS","name":"Tanzanian Shilling"},{"code":"THB","name":"Thai Baht"},{"code":"TOP","name":"Tongan Paʻanga"},{"code":"TTD","name":"Trinidad & Tobago Dollar"},{"code":"TND","name":"Tunisian Dinar"},{"code":"TRY","name":"Turkish Lira"},{"code":"TMT","name":"Turkmenistani Manat"},{"code":"UGX","name":"Ugandan Shilling"},{"code":"UAH","name":"Ukrainian Hryvnia"},{"code":"AED","name":"United Arab Emirates Dirham"},{"code":"UYU","name":"Uruguayan Peso"},{"code":"USD","name":"US Dollar"},{"code":"UZS","name":"Uzbekistani Som"},{"code":"VUV","name":"Vanuatu Vatu"},{"code":"VES","name":"Venezuelan Bolívar"},{"code":"VND","name":"Vietnamese Dong"},{"code":"XOF","name":"West African CFA Franc"},{"code":"YER","name":"Yemeni Rial"},{"code":"ZMW","name":"Zambian Kwacha"},{"code":"ZWL","name":"Zimbabwean Dollar (2009–2024)"},{"code":"ZWG","name":"Zimbabwean Gold"}],"locale":"en"},"meta":{"timestamp":"2026-06-01T23:40:41.121Z","request_id":"e01646aa-0a5d-48b0-aa87-70d80de4df4f"},"status":"ok","message":"Names listed","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/name":{"get":{"operationId":"get_v1_name","tags":["Localized Names"],"summary":"Localized name of a code","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"The code (US, de, EUR, Latn…)","schema":{"type":"string"},"example":"US"},{"name":"type","in":"query","required":false,"description":"region, language, currency, script, calendar","schema":{"type":"string"},"example":"region"},{"name":"locale","in":"query","required":false,"description":"BCP 47 locale","schema":{"type":"string"},"example":"fr"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"US","name":"États-Unis","type":"region","known":true,"locale":"fr"},"meta":{"timestamp":"2026-06-01T23:40:41.233Z","request_id":"acc48bdb-058a-45c5-a07f-4b9888dee65b"},"status":"ok","message":"Name resolved","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":"Types & example locales","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Get the localized display name of a code in any language — countries/regions, languages, currencies, scripts and calendars. /v1/name?code=US&type=region&locale=fr returns 'États-Unis'; code=de&type=language&locale=fr returns 'allemand'; code=EUR&type=currency returns 'Euro'. /v1/list?type=region&locale=ja returns every country name localized (e.g. for a Japanese country dropdown), sorted in that locale's collation; works for region, language and currency (and calendar/script). Powered by the platform's full ICU data (Intl.DisplayNames), computed locally with no network calls. Ideal for building localized country/language/currency pickers, internationalised forms and multilingual UIs. A localized-names resolver — distinct from country reference data in English (countries), number/currency formatting (numberformat) and locale date formatting (datelocale). No key, no cache.","types":["region","language","currency","script","calendar","dateTimeField"],"endpoints":["/v1/name","/v1/list","/v1/meta"],"example_locales":["en","de","fr","es","ja","ar","pt-BR","zh"]},"meta":{"timestamp":"2026-06-01T23:40:41.334Z","request_id":"64787fd9-691a-40df-a3ff-925985511b8f"},"status":"ok","message":"Meta retrieved","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":2040,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":600,"monthly_call_quota":38500,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1990,"monthly_call_quota":206000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5200,"monthly_call_quota":795000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/displaynames-api"}