0
# Language Support
1

2
Query comprehensive information about languages supported by Azure Text Translation services. This endpoint provides metadata for translation, transliteration, and dictionary operations including language codes, native names, directionality, and available script conversions.
3

4
## Capabilities
5

6
### Get Supported Languages
7

8
Retrieves the complete set of languages supported by translation, transliteration, and dictionary operations with optional filtering by operation scope.
9

10
```python { .api }
11
def get_supported_languages(
12
    *,
13
    client_trace_id: Optional[str] = None,
14
    scope: Optional[str] = None,
15
    accept_language: Optional[str] = None,
16
    etag: Optional[str] = None,
17
    match_condition: Optional[MatchConditions] = None,
18
    **kwargs: Any
19
) -> GetSupportedLanguagesResult
20
```
21

22
**Parameters:**
23
- `client_trace_id`: Client-generated GUID for request tracking
24
- `scope`: Comma-separated list filtering results ("translation", "transliteration", "dictionary")
25
- `accept_language`: BCP 47 language tag for localized language names
26
- `etag`: Resource version for caching support
27
- `match_condition`: Conditional request behavior
28

29
**Returns:** Complete language support information organized by operation type
30

31
### Usage Examples
32

33
```python
34
from azure.ai.translation.text import TextTranslationClient
35
from azure.core.credentials import AzureKeyCredential
36

37
client = TextTranslationClient(
38
    credential=AzureKeyCredential("your-api-key"),
39
    region="your-region"
40
)
41

42
# Get all supported languages
43
response = client.get_supported_languages()
44

45
# Print translation languages
46
if response.translation:
47
    for code, language in response.translation.items():
48
        print(f"{code}: {language.name} ({language.native_name})")
49

50
# Get only translation languages
51
translation_only = client.get_supported_languages(scope="translation")
52

53
# Get localized names in French
54
french_names = client.get_supported_languages(accept_language="fr")
55
```
56

57
## Response Types
58

59
### Language Support Result
60

61
```python { .api }
62
class GetSupportedLanguagesResult(dict):
63
    translation: Optional[Dict[str, TranslationLanguage]]
64
    transliteration: Optional[Dict[str, TransliterationLanguage]]
65
    dictionary: Optional[Dict[str, SourceDictionaryLanguage]]
66
```
67

68
### Translation Language Information
69

70
```python { .api }
71
class TranslationLanguage:
72
    name: str  # Display name in requested locale
73
    native_name: str  # Native language name
74
    dir: LanguageDirectionality  # Text directionality (ltr/rtl)
75
```
76

77
### Transliteration Language Information
78

79
```python { .api }
80
class TransliterationLanguage:
81
    name: str  # Display name in requested locale
82
    native_name: str  # Native language name
83
    scripts: List[LanguageScript]  # Available script conversions
84

85
class LanguageScript:
86
    code: str  # Script identifier
87
    name: str  # Display name
88
    native_name: str  # Native script name
89
    dir: LanguageDirectionality  # Text directionality
90
    to_scripts: List[TransliterableScript]  # Conversion targets
91

92
class TransliterableScript:
93
    code: str  # Target script identifier
94
    name: str  # Display name
95
    native_name: str  # Native script name
96
    dir: LanguageDirectionality  # Text directionality
97
```
98

99
### Dictionary Language Information
100

101
```python { .api }
102
class SourceDictionaryLanguage:
103
    name: str  # Display name in requested locale
104
    native_name: str  # Native language name
105
    dir: LanguageDirectionality  # Text directionality
106
    translations: List[TargetDictionaryLanguage]  # Available dictionary targets
107

108
class TargetDictionaryLanguage:
109
    code: str  # Target language code
110
    name: str  # Display name
111
    native_name: str  # Native language name
112
    dir: LanguageDirectionality  # Text directionality
113
```
114

115
## Language Directionality
116

117
```python { .api }
118
class LanguageDirectionality(str, Enum):
119
    LTR = "ltr"  # Left-to-right languages (English, Spanish, etc.)
120
    RTL = "rtl"  # Right-to-left languages (Arabic, Hebrew, etc.)
121
```