Localization and multi-language support

Last updated: 2025-03-20Contributors
Edit this page

There are two types of content returned by the API: - Internal, technical content - Content intended for display

Internal and technical content refers to facets of the RingCentral API itself: parameters, enumerations, and other API elements intended for machines to consume, not humans. This content is always in US English, and is never localized because it must remain constant so that software programs can reliably code against their values.

Content intended for display includes things like error messages, descriptive human-readable labels for dictionary items, etc. This content is usually localized. To change the region or language this content is localized for, one can pass the preferred language (locale) code in the Accept-Language HTTP header. If this header is omitted, incorrect, or contains unsupported language code, the server returns localized content in the language configured in the current user's regional settings (by default, en-US for RingCentral US and Canada accounts, en-GB for RingCentral UK accounts). The actual language code is returned in the Content-Language HTTP header.

RingCentral API currently supports the following values in the Accept-Language header.

Language Locale code
German de-DE
English (U.K.) en-GB
English (U.S.) en-US
Spanish es-ES
Spanish (Latin America) es-419
French fr-FR
French (Canada) fr-CA
Italian it-IT
Dutch (Netherlands) nl-NL
Portuguese (Brazil) pt-BR
Portuguese (Portugal) pt-PT
Finnish fi-FI
Korean (South Korea) ko_KR
Japanese ja-JP
Simplified Chinese (PRC) zh-CN
Traditional Chinese (Taiwan) zh-TW
Traditional Chinese (Hong Kong) zh-HK

Rate this page: