# 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"
```

#### `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"
```

### Meta

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

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


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