List of languages
Setting a person’s language field value may be necessary for audience segmentation and to identify which languages you need to support in your email campaigns, using Ortto’s multi-language feature.
To create or update a person with a language preference, using the POST method at https://api.ap3api.com/v1/person/merge
, include in your request body the language object as follows:
{
"people": [
{
"fields": {
"str::first": "Chris",
"str::last": "Smith",
"str::email": "chris.smith@example.com",
"str::language": "de"
}
}
]
}
Ortto customers who have their instance region set to Australia or Europe will need to use specific service endpoints relative to the region:
For example: https://api.eu.ap3api.com/v1/<entity/endpoint> All other Ortto users will use the default service endpoint (https://api.ap3api.com/). |
Or to find people based on their language, using the POST method at https://api.ap3api.com/v1/person/get
, add a filter like the following:
{
"limit": 100,
"sort_by_field_id": "str::first",
"sort_order": "asc",
"offset": 0,
"filter": {
"$str::is":{
"field_id": "str::language",
"value": "de"
}
}
}
Valid languages
The following table indicates all valid languages available in Ortto.
Language value | Description |
---|---|
"af" |
Afrikaans |
"an" |
Aragonese |
"ar" |
Arabic |
"ar-ae" |
Arabic (UAE) |
"ar-bh" |
Arabic (Bahrain) |
"ar-dz" |
Arabic (Algeria) |
"ar-eg" |
Arabic (Egypt) |
"ar-iq" |
Arabic (Iraq) |
"ar-jo" |
Arabic (Jordan) |
"ar-kw" |
Arabic (Kuwait) |
"ar-lb" |
Arabic (Lebanon) |
"ar-ly" |
Arabic (Libya) |
"ar-ma" |
Arabic (Morocco) |
"ar-om" |
Arabic (Oman) |
"ar-qa" |
Arabic (Qatar) |
"ar-sa" |
Arabic (Saudi Arabia) |
"ar-sy" |
Arabic (Syria) |
"ar-tn" |
Arabic (Tunisia) |
"ar-ye" |
Arabic (Yemen) |
"as" |
Assamese |
"ast" |
Asturian; Bable; Leonese; Asturleonese |
"az" |
Azerbaijani |
"be" |
Belarusian |
"bg" |
Bulgarian |
"bn" |
Bengali |
"br" |
Breton |
"bs" |
Bosnian |
"ca" |
Catalan |
"ce" |
Chechen |
"ch" |
Chamorro |
"co" |
Corsican |
"cr" |
Cree |
"cs" |
Czech |
"cv" |
Chuvash |
"cy" |
Welsh |
"da" |
Danish |
"de" |
German (standard) |
"de-at" |
German (Austria) |
"de-ch" |
German (Switzerland) |
"de-de" |
German (Germany) |
"de-li" |
German (Liechtenstein) |
"de-lu" |
German (Luxembourg) |
"el" |
Greek |
"en" |
English |
"en-au" |
English (Australian) |
"en-bz" |
English (Belize) |
"en-ca" |
English (Canada) |
"en-gb" |
English (United Kingdom) |
"en-ie" |
English (Ireland) |
"en-jm" |
English (Jamaica) |
"en-nz" |
English (New Zealand) |
"en-ph" |
English (Republic of the Philippines) |
"en-tt" |
English (Trinidad) |
"en-us" |
English (United States) |
"en-za" |
English (South Africa) |
"en-zw" |
English (Zimbabwe) |
"eo" |
Esperanto |
"es" |
Spanish |
"es-ar" |
Spanish (Argentina) |
"es-bo" |
Spanish (Bolivia) |
"es-cl" |
Spanish (Chile) |
"es-co" |
Spanish (Colombia) |
"es-cr" |
Spanish (Costa Rica) |
"es-do" |
Spanish (Dominican Republic) |
"es-ec" |
Spanish (Ecuador) |
"es-es" |
Spanish (Spain) |
"es-gt" |
Spanish (Guatemala) |
"es-hn" |
Spanish (Honduras) |
"es-mx" |
Spanish (Mexico) |
"es-ni" |
Spanish (Nicaragua) |
"es-pa" |
Spanish (Panama) |
"es-pe" |
Spanish (Peru) |
"es-pr" |
Spanish (Puerto Rico) |
"es-py" |
Spanish (Paraguay) |
"es-sv" |
Spanish (El Salvador) |
"es-uy" |
Spanish (Uruguay) |
"es-ve" |
Spanish (Venezuela) |
"et" |
Estonian |
"eu" |
Basque |
"fa" |
Farsi |
"fa-ir" |
Farsi (Iran) |
"fi" |
Finnish |
"fj" |
Fijian |
"fo" |
Faroese |
"fr" |
French |
"fr-be" |
French (Belgium) |
"fr-ca" |
French (Canada) |
"fr-ch" |
French (Switzerland) |
"fr-fr" |
French (France) |
"fr-lu" |
French (Luxembourg) |
"fr-mc" |
French (Monaco) |
"fur" |
Friulian |
"fy" |
Western Frisian |
"ga" |
Irish |
"gd" |
Gaelic (Scotland) |
"gd-ie" |
Gaelic (Ireland) |
"gl" |
Galician |
"gu" |
Gujarati |
"he" |
Hebrew |
"hi" |
Hindi |
"hr" |
Croatian |
"hsb" |
Upper Sorbian |
"ht" |
Haitian |
"hu" |
Hungarian |
"hy" |
Armenian |
"id" |
Indonesian |
"is" |
Icelandic |
"it" |
Italian |
"it-ch" |
Italian (Switzerland) |
"iu" |
Inuktitut |
"ja" |
Japanese |
"ji" |
Yiddish |
"ka" |
Georgian |
"kk" |
Kazakh |
"km" |
Central Khmer |
"kn" |
Kannada |
"ko" |
Korean |
"ko-kp" |
Korean (North Korea) |
"ko-kr" |
Korean (South Korea) |
"ks" |
Kashmiri |
"ky" |
Kirghiz |
"la" |
Latin |
"lb" |
Luxembourgish |
"lt" |
Lithuanian |
"lv" |
Latvian |
"mi" |
Maori |
"mk" |
Macedonian |
"ml" |
Malayalam |
"mo" |
Moldovan |
"mr" |
Marathi |
"ms" |
Malay |
"mt" |
Maltese |
"my" |
Burmese |
"nb" |
Norwegian Bokmål |
"ne" |
Nepali |
"ng" |
Ndonga |
"nl" |
Dutch; Flemish |
"nl-be" |
Dutch (Belgium) |
"nn" |
Norwegian Nynorsk |
"no" |
Norwegian |
"nv" |
Navajo |
"oc" |
Occitan |
"om" |
Oromo |
"or" |
Oriya |
"pa" |
Punjabi |
"pa-in" |
Punjabi (India) |
"pa-pk" |
Punjabi (Pakistan) |
"pl" |
Polish |
"pt" |
Portugueuse |
"pt-br" |
Portuguese (Brazil) |
"qu" |
Quechua |
"rm" |
Romansh |
"ro" |
Romanian |
"ro-mo" |
Romanian (Moldova) |
"ru" |
Russian |
"ru-mo" |
Russian (Mordovia) |
"sa" |
Sanskrit |
"sb" |
Sorbian |
"sc" |
Sardinian |
"sd" |
Sindhi |
"sg" |
Sango |
"si" |
Sinhala |
"sk" |
Slovak |
"sl" |
Slovenian |
"so" |
Somali |
"sq" |
Albanian |
"sr" |
Serbian |
"sv" |
Swedish |
"sv-fi" |
Swedish (Finland) |
"sv-sv" |
Swedish (Sweden) |
"sw" |
Swahili |
"sx" |
Sint Maarten |
"sz" |
Eswatini |
"ta" |
Tamil |
"te" |
Telugu |
"th" |
Thai |
"tig" |
Tigre |
"tk" |
Turkmen |
"tlh" |
Klingon; tlhIngan-Hol |
"tn" |
Tswana |
"tr" |
Turkish |
"ts" |
Tsonga |
"tt" |
Tatar |
"uk" |
Ukrainian |
"ur" |
Urdu |
"ve" |
Venda |
"vi" |
Vietnamese |
"vo" |
Volapük |
"wa" |
Walloon |
"xh" |
Xhosa |
"zh" |
Chinese |
"zh-cn" |
Chinese (China) |
"zh-hk" |
Chinese (Hong Kong) |
"zh-sg" |
Chinese (Singapore) |
"zh-tw" |
Chinese (Taiwan) |
"zu" |
Zulu |