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:
Example create/update people request body in Ortto’s CDP
json
{ "people": [ { "fields": { "str::first": "Chris", "str::last": "Smith", "str::email": "chris.smith@example.com", "str::language": "de" } } ] }
NOTE: Ortto customers who have their instance region set to Australia or Europe will need to use specific service endpoints relative to the region:
- Australia: https://api.au.ap3api.com/
- Europe: https://api.eu.ap3api.com/
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:
Example create/update people request body in Ortto’s CDP
shell
{ "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 |