List of timezones
When sending date activities, it is required that you provide the timezone of the date so that it can be stored correctly. Ideally, you would use a consistent time zone across your entire account, but this is not required. Here is an example of an activity request with a date attribute:
curl --location\
--request POST 'https://api.ap3api.com/v1/activities/create'\
--header 'X-Api-Key: YOUR-REAL-API-KEY-HERE'\
--header 'Content-Type: application/json'\
--data-raw '{
"activities":[
{
"activity_id":"act:cm:visited-store",
"fields": {
"str::first": "Chris",
"str::last": "Smith",
"str::email": "chris.smith@example.com"
},
"attributes": {
"dtz:cm:visit-date": {"year":2022,"month":3,"day":4,"timezone":"Africa/Abidjan"}
}
}
]
}'
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/). |
If you provide an invalid timezone, your request will fail like so:
{"request_id":"4a7db0c6-1644-4505-a903-c07450bd0ce7","code":500,"error":"Internal Server Error"}
Valid timezones
The following list indicates all valid timezones available in Ortto:
-
UTC
-
Africa/Abidjan
-
Africa/Accra
-
Africa/Algiers
-
Africa/Bissau
-
Africa/Cairo
-
Africa/Casablanca
-
Africa/Ceuta
-
Africa/El_Aaiun
-
Africa/Johannesburg
-
Africa/Juba
-
Africa/Khartoum
-
Africa/Lagos
-
Africa/Maputo
-
Africa/Monrovia
-
Africa/Nairobi
-
Africa/Ndjamena
-
Africa/Sao_Tome
-
Africa/Tripoli
-
Africa/Tunis
-
Africa/Windhoek
-
America/Adak
-
America/Anchorage
-
America/Araguaina
-
America/Argentina/Buenos_Aires
-
America/Argentina/Catamarca
-
America/Argentina/Cordoba
-
America/Argentina/Jujuy
-
America/Argentina/La_Rioja
-
America/Argentina/Mendoza
-
America/Argentina/Rio_Gallegos
-
America/Argentina/Salta
-
America/Argentina/San_Juan
-
America/Argentina/San_Luis
-
America/Argentina/Tucuman
-
America/Argentina/Ushuaia
-
America/Asuncion
-
America/Atikokan
-
America/Bahia
-
America/Bahia_Banderas
-
America/Barbados
-
America/Belem
-
America/Belize
-
America/Blanc-Sablon
-
America/Boa_Vista
-
America/Bogota
-
America/Boise
-
America/Cambridge_Bay
-
America/Campo_Grande
-
America/Cancun
-
America/Caracas
-
America/Cayenne
-
America/Chicago
-
America/Chihuahua
-
America/Costa_Rica
-
America/Creston
-
America/Cuiaba
-
America/Curacao
-
America/Danmarkshavn
-
America/Dawson
-
America/Dawson_Creek
-
America/Denver
-
America/Detroit
-
America/Edmonton
-
America/Eirunepe
-
America/El_Salvador
-
America/Fort_Nelson
-
America/Fortaleza
-
America/Glace_Bay
-
America/Godthab
-
America/Goose_Bay
-
America/Grand_Turk
-
America/Guatemala
-
America/Guayaquil
-
America/Guyana
-
America/Halifax
-
America/Havana
-
America/Hermosillo
-
America/Indiana/Indianapolis
-
America/Indiana/Knox
-
America/Indiana/Marengo
-
America/Indiana/Petersburg
-
America/Indiana/Tell_City
-
America/Indiana/Vevay
-
America/Indiana/Vincennes
-
America/Indiana/Winamac
-
America/Inuvik
-
America/Iqaluit
-
America/Jamaica
-
America/Juneau
-
America/Kentucky/Louisville
-
America/Kentucky/Monticello
-
America/La_Paz
-
America/Lima
-
America/Los_Angeles
-
America/Maceio
-
America/Managua
-
America/Manaus
-
America/Martinique
-
America/Matamoros
-
America/Mazatlan
-
America/Menominee
-
America/Merida
-
America/Metlakatla
-
America/Mexico_City
-
America/Miquelon
-
America/Moncton
-
America/Monterrey
-
America/Montevideo
-
America/Nassau
-
America/New_York
-
America/Nipigon
-
America/Nome
-
America/Noronha
-
America/North_Dakota/Beulah
-
America/North_Dakota/Center
-
America/North_Dakota/New_Salem
-
America/Ojinaga
-
America/Panama
-
America/Pangnirtung
-
America/Paramaribo
-
America/Phoenix
-
America/Port-au-Prince
-
America/Port_of_Spain
-
America/Porto_Velho
-
America/Puerto_Rico
-
America/Punta_Arenas
-
America/Rainy_River
-
America/Rankin_Inlet
-
America/Recife
-
America/Regina
-
America/Resolute
-
America/Rio_Branco
-
America/Santarem
-
America/Santiago
-
America/Santo_Domingo
-
America/Sao_Paulo
-
America/Scoresbysund
-
America/Sitka
-
America/St_Johns
-
America/Swift_Current
-
America/Tegucigalpa
-
America/Thule
-
America/Thunder_Bay
-
America/Tijuana
-
America/Toronto
-
America/Vancouver
-
America/Whitehorse
-
America/Winnipeg
-
America/Yakutat
-
America/Yellowknife
-
Antarctica/Casey
-
Antarctica/Davis
-
Antarctica/DumontDUrville
-
Antarctica/Macquarie
-
Antarctica/Mawson
-
Antarctica/Palmer
-
Antarctica/Rothera
-
Antarctica/Syowa
-
Antarctica/Troll
-
Antarctica/Vostok
-
Asia/Almaty
-
Asia/Amman
-
Asia/Anadyr
-
Asia/Aqtau
-
Asia/Aqtobe
-
Asia/Ashgabat
-
Asia/Atyrau
-
Asia/Baghdad
-
Asia/Baku
-
Asia/Bangkok
-
Asia/Barnaul
-
Asia/Beirut
-
Asia/Bishkek
-
Asia/Brunei
-
Asia/Chita
-
Asia/Choibalsan
-
Asia/Colombo
-
Asia/Damascus
-
Asia/Dhaka
-
Asia/Dili
-
Asia/Dubai
-
Asia/Dushanbe
-
Asia/Famagusta
-
Asia/Gaza
-
Asia/Hebron
-
Asia/Ho_Chi_Minh
-
Asia/Hong_Kong
-
Asia/Hovd
-
Asia/Irkutsk
-
Asia/Jakarta
-
Asia/Jayapura
-
Asia/Jerusalem
-
Asia/Kabul
-
Asia/Kamchatka
-
Asia/Karachi
-
Asia/Kathmandu
-
Asia/Khandyga
-
Asia/Kolkata
-
Asia/Krasnoyarsk
-
Asia/Kuala_Lumpur
-
Asia/Kuching
-
Asia/Macau
-
Asia/Magadan
-
Asia/Makassar
-
Asia/Manila
-
Asia/Nicosia
-
Asia/Novokuznetsk
-
Asia/Novosibirsk
-
Asia/Omsk
-
Asia/Oral
-
Asia/Pontianak
-
Asia/Pyongyang
-
Asia/Qatar
-
Asia/Qostanay
-
Asia/Qyzylorda
-
Asia/Riyadh
-
Asia/Sakhalin
-
Asia/Samarkand
-
Asia/Seoul
-
Asia/Shanghai
-
Asia/Singapore
-
Asia/Srednekolymsk
-
Asia/Taipei
-
Asia/Tashkent
-
Asia/Tbilisi
-
Asia/Tehran
-
Asia/Thimphu
-
Asia/Tokyo
-
Asia/Tomsk
-
Asia/Ulaanbaatar
-
Asia/Urumqi
-
Asia/Ust-Nera
-
Asia/Vladivostok
-
Asia/Yakutsk
-
Asia/Yangon
-
Asia/Yekaterinburg
-
Asia/Yerevan
-
Atlantic/Azores
-
Atlantic/Bermuda
-
Atlantic/Canary
-
Atlantic/Cape_Verde
-
Atlantic/Faroe
-
Atlantic/Madeira
-
Atlantic/Reykjavik
-
Atlantic/South_Georgia
-
Atlantic/Stanley
-
Australia/Adelaide
-
Australia/Brisbane
-
Australia/Broken_Hill
-
Australia/Currie
-
Australia/Darwin
-
Australia/Eucla
-
Australia/Hobart
-
Australia/Lindeman
-
Australia/Lord_Howe
-
Australia/Melbourne
-
Australia/Perth
-
Australia/Sydney
-
Europe/Amsterdam
-
Europe/Andorra
-
Europe/Astrakhan
-
Europe/Athens
-
Europe/Belgrade
-
Europe/Berlin
-
Europe/Brussels
-
Europe/Bucharest
-
Europe/Budapest
-
Europe/Chisinau
-
Europe/Copenhagen
-
Europe/Dublin
-
Europe/Gibraltar
-
Europe/Helsinki
-
Europe/Istanbul
-
Europe/Kaliningrad
-
Europe/Kyiv
-
Europe/Kirov
-
Europe/Lisbon
-
Europe/London
-
Europe/Luxembourg
-
Europe/Madrid
-
Europe/Malta
-
Europe/Minsk
-
Europe/Monaco
-
Europe/Moscow
-
Europe/Oslo
-
Europe/Paris
-
Europe/Prague
-
Europe/Riga
-
Europe/Rome
-
Europe/Samara
-
Europe/Saratov
-
Europe/Simferopol
-
Europe/Sofia
-
Europe/Stockholm
-
Europe/Tallinn
-
Europe/Tirane
-
Europe/Ulyanovsk
-
Europe/Uzhgorod
-
Europe/Vienna
-
Europe/Vilnius
-
Europe/Volgograd
-
Europe/Warsaw
-
Europe/Zaporozhye
-
Europe/Zurich
-
Indian/Chagos
-
Indian/Christmas
-
Indian/Cocos
-
Indian/Kerguelen
-
Indian/Mahe
-
Indian/Maldives
-
Indian/Mauritius
-
Indian/Reunion
-
Pacific/Apia
-
Pacific/Auckland
-
Pacific/Bougainville
-
Pacific/Chatham
-
Pacific/Chuuk
-
Pacific/Easter
-
Pacific/Efate
-
Pacific/Enderbury
-
Pacific/Fakaofo
-
Pacific/Fiji
-
Pacific/Funafuti
-
Pacific/Galapagos
-
Pacific/Gambier
-
Pacific/Guadalcanal
-
Pacific/Guam
-
Pacific/Honolulu
-
Pacific/Kiritimati
-
Pacific/Kosrae
-
Pacific/Kwajalein
-
Pacific/Majuro
-
Pacific/Marquesas
-
Pacific/Nauru
-
Pacific/Niue
-
Pacific/Norfolk
-
Pacific/Noumea
-
Pacific/Pago_Pago
-
Pacific/Palau
-
Pacific/Pitcairn
-
Pacific/Pohnpei
-
Pacific/Port_Moresby
-
Pacific/Rarotonga
-
Pacific/Tahiti
-
Pacific/Tarawa
-
Pacific/Tongatapu
-
Pacific/Wake
-
Pacific/Wallis