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:

  • 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/).

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