Microsoft Graph REST API Developer – Getting list of locales, languages supported for the user mailbox


Using Microsoft Graph REST API, you can get the list of locales and languages that are supported for the user, as configured on the user's mailbox server. You need to use OutlookUser resource type, which represents the Outlook services available to a given user.

Request:
https://graph.microsoft.com/beta/me/outlook/supportedLanguages

RequestHeader: Authorization, Bearer/Token is required

Response:
If successful, this method returns 200, OK response code and a collection of localeInfo objects in the response body.

So, I see the following response for a given user:

{
     "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.localeInfo)",
     "value": [
         {
             "locale": "af-ZA",
             "displayName": "Afrikaans (Suid-Afrika)"
         },
         {
             "locale": "am-ET",
             "displayName": "አማርኛ (ኢትዮጵያ)"
         },
         {
             "locale": "ar-AE",
             "displayName": "العربية (الإمارات العربية المتحدة)"
         },
         {
             "locale": "ar-BH",
             "displayName": "العربية (البحرين)"
         },
         {
             "locale": "ar-DZ",
             "displayName": "العربية (الجزائر)"
         },
         {
             "locale": "ar-EG",
             "displayName": "العربية (مصر)"
         },
         {
             "locale": "ar-IQ",
             "displayName": "العربية (العراق)"
         },
         {
             "locale": "ar-JO",
             "displayName": "العربية (الأردن)"
         },
         {
             "locale": "ar-KW",
             "displayName": "العربية (الكويت)"
         },
         {
             "locale": "ar-LB",
             "displayName": "العربية (لبنان)"
         },
         {
             "locale": "ar-LY",
             "displayName": "العربية (ليبيا)"
         },
         {
             "locale": "ar-MA",
             "displayName": "العربية (المملكة المغربية)"
         },
         {
             "locale": "ar-OM",
             "displayName": "العربية (عمان)"
         },
         {
             "locale": "ar-QA",
             "displayName": "العربية (قطر)"
         },
         {
             "locale": "ar-SA",
             "displayName": "العربية (المملكة العربية السعودية)"
         },
         {
             "locale": "ar-SY",
             "displayName": "العربية (سوريا)"
         },
         {
             "locale": "ar-TN",
             "displayName": "العربية (تونس)"
         },
         {
             "locale": "ar-YE",
             "displayName": "العربية (اليمن)"
         },
         {
             "locale": "as-IN",
             "displayName": "অসমীয়া (ভাৰত)"
         },
         {
             "locale": "az-Latn-AZ",
             "displayName": "Azərbaycan dili (Azərbaycan)"
         },
         {
             "locale": "be-BY",
             "displayName": "Беларуская (Беларусь)"
         },
         {
             "locale": "bg-BG",
             "displayName": "български (България)"
         },
         {
             "locale": "bn-BD",
             "displayName": "বাংলা (বাংলাদেশ)"
         },
         {
             "locale": "bn-IN",
             "displayName": "বাংলা (ভারত)"
         },
         {
             "locale": "bs-Latn-BA",
             "displayName": "bosanski (Bosna i Hercegovina)"
         },
         {
             "locale": "ca-ES",
             "displayName": "Català (Català)"
         },
         {
             "locale": "ca-ES-valencia",
             "displayName": "Valencià (Espanya)"
         },
         {
             "locale": "cs-CZ",
             "displayName": "čeština (Česká republika)"
         },
         {
             "locale": "cy-GB",
             "displayName": "Cymraeg (Y Deyrnas Unedig)"
         },
         {
             "locale": "da-DK",
             "displayName": "dansk (Danmark)"
         },
         {
             "locale": "de-AT",
             "displayName": "Deutsch (Österreich)"
         },
         {
             "locale": "de-CH",
             "displayName": "Deutsch (Schweiz)"
         },
         {
             "locale": "de-DE",
             "displayName": "Deutsch (Deutschland)"
         },
         {
             "locale": "de-LI",
             "displayName": "Deutsch (Liechtenstein)"
         },
         {
             "locale": "de-LU",
             "displayName": "Deutsch (Luxemburg)"
         },
         {
             "locale": "el-GR",
             "displayName": "Ελληνικά (Ελλάδα)"
         },
         {
             "locale": "en-029",
             "displayName": "English (Caribbean)"
         },
         {
             "locale": "en-AU",
             "displayName": "English (Australia)"
         },
         {
             "locale": "en-BZ",
             "displayName": "English (Belize)"
         },
         {
             "locale": "en-CA",
             "displayName": "English (Canada)"
         },
         {
             "locale": "en-GB",
             "displayName": "English (United Kingdom)"
         },
         {
             "locale": "en-IE",
             "displayName": "English (Ireland)"
         },
         {
             "locale": "en-IN",
             "displayName": "English (India)"
         },
         {
             "locale": "en-JM",
             "displayName": "English (Jamaica)"
         },
         {
             "locale": "en-MY",
             "displayName": "English (Malaysia)"
         },
         {
             "locale": "en-NZ",
             "displayName": "English (New Zealand)"
         },
         {
             "locale": "en-PH",
             "displayName": "English (Philippines)"
         },
         {
             "locale": "en-SG",
             "displayName": "English (Singapore)"
         },
         {
             "locale": "en-TT",
             "displayName": "English (Trinidad and Tobago)"
         },
         {
             "locale": "en-US",
             "displayName": "English (United States)"
         },
         {
             "locale": "en-ZA",
             "displayName": "English (South Africa)"
         },
         {
             "locale": "en-ZW",
             "displayName": "English (Zimbabwe)"
         },
         {
             "locale": "es-AR",
             "displayName": "español (Argentina)"
         },
         {
             "locale": "es-BO",
             "displayName": "español (Bolivia)"
         },
         {
             "locale": "es-CL",
             "displayName": "español (Chile)"
         },
         {
             "locale": "es-CO",
             "displayName": "español (Colombia)"
         },
         {
             "locale": "es-CR",
             "displayName": "español (Costa Rica)"
         },
         {
             "locale": "es-DO",
             "displayName": "español (República Dominicana)"
         },
         {
             "locale": "es-EC",
             "displayName": "español (Ecuador)"
         },
         {
             "locale": "es-ES",
             "displayName": "español (España, alfabetización internacional)"
         },
         {
             "locale": "es-GT",
             "displayName": "español (Guatemala)"
         },
         {
             "locale": "es-HN",
             "displayName": "español (Honduras)"
         },
         {
             "locale": "es-MX",
             "displayName": "español (México)"
         },
         {
             "locale": "es-NI",
             "displayName": "español (Nicaragua)"
         },
         {
             "locale": "es-PA",
             "displayName": "español (Panamá)"
         },
         {
             "locale": "es-PE",
             "displayName": "español (Perú)"
         },
         {
             "locale": "es-PR",
             "displayName": "español (Puerto Rico)"
         },
         {
             "locale": "es-PY",
             "displayName": "español (Paraguay)"
         },
         {
             "locale": "es-SV",
             "displayName": "español (El Salvador)"
         },
         {
             "locale": "es-US",
             "displayName": "español (Estados Unidos)"
         },
         {
             "locale": "es-UY",
             "displayName": "español (Uruguay)"
         },
         {
             "locale": "es-VE",
             "displayName": "español (Republica Bolivariana de Venezuela)"
         },
         {
             "locale": "et-EE",
             "displayName": "eesti (Eesti)"
         },
         {
             "locale": "eu-ES",
             "displayName": "euskara (euskara)"
         },
         {
             "locale": "fa-IR",
             "displayName": "فارسى (ایران)"
         },
         {
             "locale": "fi-FI",
             "displayName": "suomi (Suomi)"
         },
         {
             "locale": "fil-PH",
             "displayName": "Filipino (Pilipinas)"
         },
         {
             "locale": "fr-BE",
             "displayName": "français (Belgique)"
         },
         {
             "locale": "fr-CA",
             "displayName": "français (Canada)"
         },
         {
             "locale": "fr-CH",
             "displayName": "français (Suisse)"
         },
         {
             "locale": "fr-FR",
             "displayName": "français (France)"
         },
         {
             "locale": "fr-LU",
             "displayName": "français (Luxembourg)"
         },
         {
             "locale": "fr-MC",
             "displayName": "français (Principauté de Monaco)"
         },
         {
             "locale": "ga-IE",
             "displayName": "Gaeilge (Éire)"
         },
         {
             "locale": "gd-GB",
             "displayName": "Gàidhlig (An Rìoghachd Aonaichte)"
         },
         {
             "locale": "gl-ES",
             "displayName": "galego (galego)"
         },
         {
             "locale": "gu-IN",
             "displayName": "ગુજરાતી (ભારત)"
         },
         {
             "locale": "ha-Latn-NG",
             "displayName": "Hausa (Nijeriya)"
         },
         {
             "locale": "he-IL",
             "displayName": "עברית (ישראל)"
         },
         {
             "locale": "hi-IN",
             "displayName": "हिंदी (भारत)"
         },
         {
             "locale": "hr-BA",
             "displayName": "hrvatski (Bosna i Hercegovina)"
         },
         {
             "locale": "hr-HR",
             "displayName": "hrvatski (Hrvatska)"
         },
         {
             "locale": "hu-HU",
             "displayName": "magyar (Magyarország)"
         },
         {
             "locale": "hy-AM",
             "displayName": "Հայերեն (Հայաստան)"
         },
         {
             "locale": "id-ID",
             "displayName": "Bahasa Indonesia (Indonesia)"
         },
         {
             "locale": "is-IS",
             "displayName": "íslenska (Ísland)"
         },
         {
             "locale": "it-CH",
             "displayName": "italiano (Svizzera)"
         },
         {
             "locale": "it-IT",
             "displayName": "italiano (Italia)"
         },
         {
             "locale": "ja-JP",
             "displayName": "日本語 (日本)"
         },
         {
             "locale": "ka-GE",
             "displayName": "ქართული (საქართველო)"
         },
         {
             "locale": "kk-KZ",
             "displayName": "Қазақ (Қазақстан)"
         },
         {
             "locale": "km-KH",
             "displayName": "ភាសាខ្មែរ (កម្ពុជា)"
         },
         {
             "locale": "kn-IN",
             "displayName": "ಕನ್ನಡ (ಭಾರತ)"
         },
         {
             "locale": "ko-KR",
             "displayName": "한국어(대한민국)"
         },
         {
             "locale": "kok-IN",
             "displayName": "कोंकणी (भारत)"
         },
         {
             "locale": "ky-KG",
             "displayName": "Кыргыз (Кыргызстан)"
         },
         {
             "locale": "lb-LU",
             "displayName": "Lëtzebuergesch (Lëtzebuerg)"
         },
         {
             "locale": "lo-LA",
             "displayName": "ພາສາລາວ (ສປປ ລາວ)"
         },
         {
             "locale": "lt-LT",
             "displayName": "lietuvių (Lietuva)"
         },
         {
             "locale": "lv-LV",
             "displayName": "latviešu (Latvija)"
         },
         {
             "locale": "mi-NZ",
             "displayName": "Reo Māori (Aotearoa)"
         },
         {
             "locale": "mk-MK",
             "displayName": "македонски јазик (Македонија)"
         },
         {
             "locale": "ml-IN",
             "displayName": "മലയാളം (ഭാരതം)"
         },
         {
             "locale": "mn-MN",
             "displayName": "Монгол хэл (Монгол улс)"
         },
         {
             "locale": "mr-IN",
             "displayName": "मराठी (भारत)"
         },
         {
             "locale": "ms-BN",
             "displayName": "Bahasa Melayu (Brunei Darussalam)"
         },
         {
             "locale": "ms-MY",
             "displayName": "Bahasa Melayu (Malaysia)"
         },
         {
             "locale": "mt-MT",
             "displayName": "Malti (Malta)"
         },
         {
             "locale": "ne-IN",
             "displayName": "नेपाली (भारत)"
         },
         {
             "locale": "ne-NP",
             "displayName": "नेपाली (नेपाल)"
         },
         {
             "locale": "nl-BE",
             "displayName": "Nederlands (België)"
         },
         {
             "locale": "nl-NL",
             "displayName": "Nederlands (Nederland)"
         },
         {
             "locale": "nn-NO",
             "displayName": "norsk, nynorsk (Noreg)"
         },
         {
             "locale": "nb-NO",
             "displayName": "norsk, bokmål (Norge)"
         },
         {
             "locale": "or-IN",
             "displayName": "ଓଡ଼ିଆ (ଭାରତ)"
         },
         {
             "locale": "pa-IN",
             "displayName": "ਪੰਜਾਬੀ (ਭਾਰਤ)"
         },
         {
             "locale": "pl-PL",
             "displayName": "polski (Polska)"
         },
         {
             "locale": "prs-AF",
             "displayName": "درى (افغانستان)"
         },
         {
             "locale": "pt-AO",
             "displayName": "português (Angola)"
         },
         {
             "locale": "pt-BR",
             "displayName": "português (Brasil)"
         },
         {
             "locale": "pt-PT",
             "displayName": "português (Portugal)"
         },
         {
             "locale": "quz-BO",
             "displayName": "runasimi (Qullasuyu)"
         },
         {
             "locale": "quz-EC",
             "displayName": "runa shimi (Ecuador Suyu)"
         },
         {
             "locale": "quz-PE",
             "displayName": "runasimi (Peru)"
         },
         {
             "locale": "ro-MD",
             "displayName": "română (Republica Moldova)"
         },
         {
             "locale": "ro-RO",
             "displayName": "română (România)"
         },
         {
             "locale": "ru-RU",
             "displayName": "русский (Россия)"
         },
         {
             "locale": "sd-Arab-PK",
             "displayName": "سنڌي (پاکستان)"
         },
         {
             "locale": "si-LK",
             "displayName": "සිංහල (ශ්‍රී ලංකා)"
         },
         {
             "locale": "sk-SK",
             "displayName": "slovenčina (Slovenská republika)"
         },
         {
             "locale": "sl-SI",
             "displayName": "slovenščina (Slovenija)"
         },
         {
             "locale": "sq-AL",
             "displayName": "Shqip (Shqipëria)"
         },
         {
             "locale": "sr-Latn-CS",
             "displayName": "srpski (Srbija i Crna Gora (Bivša))"
         },
         {
             "locale": "sr-Cyrl-BA",
             "displayName": "српски (Босна и Херцеговина)"
         },
         {
             "locale": "sr-Cyrl-CS",
             "displayName": "српски (Србија и Црна Гора (Бивша))"
         },
         {
             "locale": "sv-FI",
             "displayName": "svenska (Finland)"
         },
         {
             "locale": "sv-SE",
             "displayName": "svenska (Sverige)"
         },
         {
             "locale": "sw-KE",
             "displayName": "Kiswahili (Kenya)"
         },
         {
             "locale": "ta-IN",
             "displayName": "தமிழ் (இந்தியா)"
         },
         {
             "locale": "te-IN",
             "displayName": "తెలుగు (భారత దేశం)"
         },
         {
             "locale": "th-TH",
             "displayName": "ไทย (ไทย)"
         },
         {
             "locale": "tk-TM",
             "displayName": "Türkmen dili (Türkmenistan)"
         },
         {
             "locale": "tr-TR",
             "displayName": "Türkçe (Türkiye)"
         },
         {
             "locale": "tt-RU",
             "displayName": "Татар (Россия)"
         },
         {
             "locale": "ug-CN",
             "displayName": "ئۇيغۇرچە (جۇڭخۇا خەلق جۇمھۇرىيىتى)"
         },
         {
             "locale": "uk-UA",
             "displayName": "українська (Україна)"
         },
         {
             "locale": "ur-IN",
             "displayName": "اردو (بھارت)"
         },
         {
             "locale": "ur-PK",
             "displayName": "اُردو (پاکستان)"
         },
         {
             "locale": "uz-Latn-UZ",
             "displayName": "O'zbekcha (O'zbekiston Respublikasi)"
         },
         {
             "locale": "vi-VN",
             "displayName": "Tiếng Việt (Việt Nam)"
         },
         {
             "locale": "zh-CN",
             "displayName": "中文(中华人民共和国)"
         },
         {
             "locale": "zh-SG",
             "displayName": "中文(新加坡)"
         },
         {
             "locale": "zh-HK",
             "displayName": "中文(香港特別行政區)"
         },
         {
             "locale": "zh-MO",
             "displayName": "中文(澳門特別行政區)"
         },
         {
             "locale": "zh-TW",
             "displayName": "中文(台灣)"
         }
     ]
}

Permissions:

Permission type

Permissions (from least to most privileged)

Delegated (work or school account)

User.Read, User.ReadBasic.All

Delegated (personal Microsoft account)

User.Read

Application

User.Read.All

Please note,

- APIs under the /beta version in Microsoft Graph are in preview and are subject to change.
- Use of these APIs in production applications is not supported.

Happy development!!

Comments (0)

Skip to main content