# Localized Names API
> 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.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/displaynames-api/..."
```

## Pricing
- **Free** (Free) — 2,040 calls/Mo, 2 req/s
- **Starter** ($6/Mo) — 38,500 calls/Mo, 8 req/s
- **Pro** ($20/Mo) — 206,000 calls/Mo, 20 req/s
- **Mega** ($52/Mo) — 795,000 calls/Mo, 50 req/s

## Endpoints

### Localized Names

#### `GET /v1/list` — All codes of a type, localized

**Parameters:**
- `type` (query, optional, string) — region, language, currency, calendar Example: `currency`
- `locale` (query, optional, string) — BCP 47 locale Example: `en`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/displaynames-api/v1/list?type=currency&locale=en"
```

**Response:**
```json
{
    "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"
       
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/name` — Localized name of a code

**Parameters:**
- `code` (query, required, string) — The code (US, de, EUR, Latn…) Example: `US`
- `type` (query, optional, string) — region, language, currency, script, calendar Example: `region`
- `locale` (query, optional, string) — BCP 47 locale Example: `fr`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/displaynames-api/v1/name?code=US&type=region&locale=fr"
```

**Response:**
```json
{
    "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
}
```

### Meta

#### `GET /v1/meta` — Types & example locales

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/displaynames-api/v1/meta"
```

**Response:**
```json
{
    "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-
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/displaynames-api
OpenAPI spec: https://www.oanor.com/api/displaynames-api/openapi.json