Get the default language for this Erply account.

For a list of all supported languages, see getAllLanguages; for a list of currently activated languages, see getActiveLanguages.

For more information about languages in Erply, see this article.


Field name Type Description
name String Name of the language in English.
nativeName String The language's native name, eg. "Español", "Ελληνικά" or "简体中文".
shortDisplayName String A shorter identifier for the language. Erply back office uses it in field and column labels, such as “Name FRA” or “Description FRA”.
legacyIdentifier String

A three-letter identifier. This is the identifier you must use in Erply API.

To get item names returned in a particular language, use input parameter lang (for example, lang=eng or lang=spa. This works in API call getProducts and many others.

A few API calls (including getProducts) also support an input parameter getNamesInAllLanguages = 1. If you set that flag, API will return fields "nameENG", "nameSPA" and so on. The last three characters in the field name are the same identifier, converted to uppercase.

The "save" API calls, eg. saveProduct also allow to set the name in multiple languages, and similarly accept input parameters "nameENG", "nameSPA" and so on.

Note that the value can sometimes be unexpected: the legacyIdentifier for French is "lat", for example. This is by design. Wherever you have the freedom to establish your own nomenclature, we recommend to use field isoCode instead.

isoCode String

Standard ISO 639-1 code for this language. This is the identifier you must use in newer APIs, such as PIM API or CRM API.

For Simplified Chinese and Traditional Chinese, the identifiers are "zh-Hans" and "zh-Hant", respectively.

countries Array List of countries where this language can be activated. (Allowing certain languages to be activated only in specific countries is due to a technical limitation.) If the array is empty, the language is available globally.
isOverride Boolean The value is "true" for languages that reuse a legacyIdentifier that belongs to some other language — such as Dutch, which repurposes the legacyIdentifier "gre".