Get all languages

Get All Languages

The /api/enums/languages endpoint returns a comprehensive list of all languages available in the Netevia Banking application. Partners can use this data to present language selection options to users during account setup or within app settings. This endpoint enhances accessibility by enabling a localized, inclusive user experience across diverse regions.

Endpoint

GET /api/enums/languages

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when building account registration flows or application settings screens that require users to select their preferred language. It is also useful when populating dropdowns or language pickers in partner-facing portals targeting multilingual user bases. Call this endpoint once during initialization and cache the results to avoid repeated lookups.

Query Parameters

Parameter	Type	Required	Description
all	boolean	No	When `true`, returns all languages including those not fully translated. Defaults to `false`, which returns only fully supported languages.

Response

200 OK

Returns an array of language objects.

Field	Type	Description
name	string	The language code or identifier (e.g., `"en"`, `"es"`).
description	string	The human-readable name of the language (e.g., `"English"`, `"Spanish"`).
auto	boolean	Indicates whether the language was automatically detected or assigned.
translated	boolean	Indicates whether the application content is fully translated into this language.

[
  {
    "name": "en",
    "description": "English",
    "auto": false,
    "translated": true
  },
  {
    "name": "es",
    "description": "Spanish",
    "auto": false,
    "translated": true
  },
  {
    "name": "fr",
    "description": "French",
    "auto": false,
    "translated": false
  }
]

Error Codes

Code	When it happens
401	Token missing, expired, or invalid
403	Insufficient permissions
500	Internal server error

Common Mistakes

Omitting the all query parameter when you need to display languages that are partially translated — without it, only fully translated languages are returned.
Not caching the response — this is a relatively static list; fetching it on every user interaction is unnecessary and adds latency.
Assuming name is always a full language name — it is a language code identifier; use description for display purposes.

Related Endpoints

GET /api/enums/countries — Retrieve the list of supported countries for use in address and profile fields.
GET /api/enums/states — Retrieve the list of supported states or regions.

Example

curl -X GET "https://api.banking.netevia.dev/api/enums/languages?all=false" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"