A user's timezone affects the displayed dates on all Suppression Lists and Statistics.

{% anchor h2 %} get {% endanchor %}

Get current timezone assigned to the user.

{% apiexample get GET https://api.sendgrid.com/api/timezone/get api_user=your_sendgrid_username&api_key=your_sendgrid_password %} {% response json %} { "name": "Eastern Time, US & Canada", "offset": 18000, "timezone": "America/New_York", "display": "GMT-05:00" } {% endresponse %} {% response xml %} Eastern Time, US & Canada 18000 America/New_York GMT-05:00 {% endresponse %} {% endapiexample %}

{% anchor h2 %} edit {% endanchor %}

Update the timezone assigned to the user.

{% parameters edit %} {% parameter timezone Yes 'IANA timezone Area/Location format' 'Timezone to set on user' %} {% endparameters %}

{% apiexample edit POST https://api.sendgrid.com/api/timezone/edit api_user=your_sendgrid_username&api_key=your_sendgrid_password&timezone=America/New_York %} {% response json %} { "message": "success" } {% endresponse %} {% response xml %} success {% endresponse %} {% endapiexample %}

{% anchor h2 %} list {% endanchor %}

This example provides the full list of IANA timezones in the SendGrid system, for reference. It's best practice to use the timezone parameter.

{% parameters list %} {% parameter timezone No 'IANA timezone Area/Location format' 'Restrict query to confirm existence of named timezone' %} {% endparameters %}

{% apiexample list GET https://api.sendgrid.com/api/timezone/list api_user=your_sendgrid_username&api_key=your_sendgrid_password %} {% response json %} [ { "timezone": "Pacific/Tongatapu", "offset": -46800, "display": "GMT+13:00", "name": "Nuku'alofa" }, { "timezone": "Pacific/Auckland", "offset": -46800, "display": "GMT+12:00", "name": "Auckland, Wellington" }, { "timezone": "Etc/GMT-12", "offset": -43200, "display": "GMT+12:00", "name": "Fiji, Kamchatka, Marshall Is." }, { "timezone": "Asia/Magadan", "offset": -43200, "display": "GMT+12:00", "name": "Magadan" }, { "timezone": "Etc/GMT-11", "offset": -39600, "display": "GMT+11:00", "name": "Solomon Is., New Caledonia" }, { "timezone": "Asia/Vladivostok", "offset": -39600, "display": "GMT+11:00", "name": "Vladivostok" }, { "timezone": "Asia/Yakutsk", "offset": -36000, "display": "GMT+10:00", "name": "Yakutsk" }, { "timezone": "Australia/Brisbane", "offset": -36000, "display": "GMT+10:00", "name": "Brisbane" }, { "timezone": "Australia/Sydney", "offset": -39600, "display": "GMT+10:00", "name": "Canberra, Melbourne, Sydney" }, { "timezone": "Australia/Hobart", "offset": -39600, "display": "GMT+10:00", "name": "Hobart" }, { "timezone": "Australia/Adelaide", "offset": -37800, "display": "GMT+09:30", "name": "Adelaide" }, { "timezone": "Australia/Darwin", "offset": -34200, "display": "GMT+09:30", "name": "Darwin" }, { "timezone": "Asia/Irkutsk", "offset": -32400, "display": "GMT+09:00", "name": "Irkutsk, Ulaan Bataar" }, { "timezone": "Asia/Tokyo", "offset": -32400, "display": "GMT+09:00", "name": "Osaka, Sapporo, Tokyo" }, { "timezone": "Asia/Seoul", "offset": -32400, "display": "GMT+09:00", "name": "Seoul" }, { "timezone": "Asia/Hong_Kong", "offset": -28800, "display": "GMT+08:00", "name": "Beijing, Chongqing, Hong Kong, Urumqi" }, { "timezone": "Asia/Krasnoyarsk", "offset": -28800, "display": "GMT+08:00", "name": "Krasnoyarsk" }, { "timezone": "Australia/Perth", "offset": -28800, "display": "GMT+08:00", "name": "Perth" }, { "timezone": "Asia/Taipei", "offset": -28800, "display": "GMT+08:00", "name": "Taipei" }, { "timezone": "Asia/Bangkok", "offset": -25200, "display": "GMT+07:00", "name": "Bangkok, Hanoi, Jakarta" }, { "timezone": "Asia/Novosibirsk", "offset": -25200, "display": "GMT+07:00", "name": "Novosibirsk" }, { "timezone": "Asia/Rangoon", "offset": -23400, "display": "GMT+06:30", "name": "Yangon Rangoon" }, { "timezone": "Asia/Dhaka", "offset": -21600, "display": "GMT+06:00", "name": "Astana, Dhaka" }, { "timezone": "Asia/Yekaterinburg", "offset": -21600, "display": "GMT+06:00", "name": "Ekaterinburg" }, { "timezone": "Asia/Katmandu", "offset": -20700, "display": "GMT+05:45", "name": "Kathmandu" }, { "timezone": "Asia/Kolkata", "offset": -19800, "display": "GMT+05:30", "name": "Chennai, Kolkata, Mumbai, New Delhi" }, { "timezone": "Asia/Tashkent", "offset": -18000, "display": "GMT+05:00", "name": "Asia/Tashkent" }, { "timezone": "Asia/Kabul", "offset": -16200, "display": "GMT+04:30", "name": "Kabul" }, { "timezone": "Asia/Dubai", "offset": -14400, "display": "GMT+04:00", "name": "Abu Dhabi, Muscat" }, { "timezone": "Asia/Baku", "offset": -14400, "display": "GMT+04:00", "name": "Baku" }, { "timezone": "Europe/Moscow", "offset": -14400, "display": "GMT+04:00", "name": "Moscow, St. Petersburg, Volgograd" }, { "timezone": "Asia/Tbilisi", "offset": -14400, "display": "GMT+04:00", "name": "Tbilisi" }, { "timezone": "Asia/Yerevan", "offset": -14400, "display": "GMT+04:00", "name": "Yerevan" }, { "timezone": "Asia/Tehran", "offset": -12600, "display": "GMT+03:30", "name": "Tehran" }, { "timezone": "Asia/Baghdad", "offset": -10800, "display": "GMT+03:00", "name": "Baghdad" }, { "timezone": "Europe/Minsk", "offset": -10800, "display": "GMT+03:00", "name": "Kaliningrad, Minsk" }, { "timezone": "Asia/Kuwait", "offset": -10800, "display": "GMT+03:00", "name": "Kuwait, Riyadh" }, { "timezone": "Africa/Addis_Ababa", "offset": -10800, "display": "GMT+03:00", "name": "Nairobi" }, { "timezone": "Asia/Amman", "offset": -7200, "display": "GMT+02:00", "name": "Amman" }, { "timezone": "Europe/Bucharest", "offset": -7200, "display": "GMT+02:00", "name": "Athens, Bucharest" }, { "timezone": "Asia/Beirut", "offset": -7200, "display": "GMT+02:00", "name": "Beirut" }, { "timezone": "Africa/Cairo", "offset": -7200, "display": "GMT+02:00", "name": "Cairo" }, { "timezone": "Asia/Damascus", "offset": -7200, "display": "GMT+02:00", "name": "Damascus" }, { "timezone": "Africa/Blantyre", "offset": -7200, "display": "GMT+02:00", "name": "Harare, Pretoria" }, { "timezone": "Europe/Helsinki", "offset": -7200, "display": "GMT+02:00", "name": "Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius" }, { "timezone": "Europe/Istanbul", "offset": -7200, "display": "GMT+02:00", "name": "Istanbul" }, { "timezone": "Asia/Jerusalem", "offset": -7200, "display": "GMT+02:00", "name": "Jerusalem" }, { "timezone": "Europe/Nicosia", "offset": -7200, "display": "GMT+02:00", "name": "Nicosia" }, { "timezone": "Europe/Amsterdam", "offset": -3600, "display": "GMT+01:00", "name": "Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna" }, { "timezone": "Europe/Belgrade", "offset": -3600, "display": "GMT+01:00", "name": "Belgrade, Bratislava, Budapest, Prague, Ljubljana" }, { "timezone": "Europe/Brussels", "offset": -3600, "display": "GMT+01:00", "name": "Brussels, Copenhagen, Madrid, Paris" }, { "timezone": "Europe/Warsaw", "offset": -3600, "display": "GMT+01:00", "name": "Sarajevo, Skopje, Warsaw, Zagreb" }, { "timezone": "Africa/Algiers", "offset": -3600, "display": "GMT+01:00", "name": "West Central Africa" }, { "timezone": "Africa/Windhoek", "offset": -7200, "display": "GMT+01:00", "name": "Windhoek" }, { "timezone": "Africa/Casablanca", "offset": 0, "display": "GMT-00:00", "name": "Casablanca" }, { "timezone": "Etc/UTC", "offset": 0, "display": "GMT-00:00", "name": "Coordinated Universal Time" }, { "timezone": "Africa/Abidjan", "offset": 0, "display": "GMT-00:00", "name": "Monrovia, Reykjavik" }, { "timezone": "Europe/London", "offset": 0, "display": "GMT-00:00", "name": "Dublin, Lisabon, London, Edinburgh" }, { "timezone": "Atlantic/Cape_Verde", "offset": 3600, "display": "GMT-01:00", "name": "Cape Verde Is." }, { "timezone": "Atlantic/Azores", "offset": 3600, "display": "GMT-01:00", "name": "Azores" }, { "timezone": "America/Noronha", "offset": 7200, "display": "GMT-02:00", "name": "Mid-Atlantic" }, { "timezone": "Etc/GMT+2", "offset": 7200, "display": "GMT-02:00", "name": "Coordinated Universal Time - 02" }, { "timezone": "America/Sao_Paulo", "offset": 7200, "display": "GMT-03:00", "name": "Brasilia" }, { "timezone": "America/Argentina/Buenos_Aires", "offset": 10800, "display": "GMT-03:00", "name": "Buenos Aires" }, { "timezone": "America/Cayenne", "offset": 10800, "display": "GMT-03:00", "name": "Cayenne, Fortalenza" }, { "timezone": "America/Godthab", "offset": 10800, "display": "GMT-03:00", "name": "Greenland" }, { "timezone": "America/Montevideo", "offset": 7200, "display": "GMT-03:00", "name": "Montevideo" }, { "timezone": "America/St_Johns", "offset": 12600, "display": "GMT-03:30", "name": "Newfoundland" }, { "timezone": "America/Asuncion", "offset": 10800, "display": "GMT-04:00", "name": "Asuncion" }, { "timezone": "America/Goose_Bay", "offset": 14400, "display": "GMT-04:00", "name": "Atlantic Time, Goose Bay" }, { "timezone": "America/Glace_Bay", "offset": 14400, "display": "GMT-04:00", "name": "Atlantic Time, Canada" }, { "timezone": "America/Cuiaba", "offset": 10800, "display": "GMT-04:00", "name": "Cuiaba" }, { "timezone": "America/La_Paz", "offset": 14400, "display": "GMT-04:00", "name": "Georgetown, La Paz, Manaus, San Juan" }, { "timezone": "America/Santiago", "offset": 10800, "display": "GMT-04:00", "name": "Santiago" }, { "timezone": "America/Caracas", "offset": 16200, "display": "GMT-04:30", "name": "Caracas" }, { "timezone": "America/Bogota", "offset": 18000, "display": "GMT-05:00", "name": "Bogota, Lima, Quito, Rio Branco" }, { "timezone": "America/New_York", "offset": 18000, "display": "GMT-05:00", "name": "Eastern Time, US & Canada" }, { "timezone": "America/Havana", "offset": 18000, "display": "GMT-05:00", "name": "Cuba" }, { "timezone": "America/Indiana/Indianapolis", "offset": 18000, "display": "GMT-05:00", "name": "Indiana (East)" }, { "timezone": "America/Belize", "offset": 21600, "display": "GMT-06:00", "name": "Central America" }, { "timezone": "America/Chicago", "offset": 21600, "display": "GMT-06:00", "name": "Central Time, US & Canada" }, { "timezone": "America/Cancun", "offset": 21600, "display": "GMT-06:00", "name": "Guadalajara, Mexico City, Monterrey" }, { "timezone": "Canada/Saskatchewan", "offset": 21600, "display": "GMT-06:00", "name": "Saskatchewan" }, { "timezone": "America/Dawson_Creek", "offset": 25200, "display": "GMT-07:00", "name": "Arizona" }, { "timezone": "America/Chihuahua", "offset": 25200, "display": "GMT-07:00", "name": "Chihuahua, La Paz, Mazatlan" }, { "timezone": "America/Denver", "offset": 25200, "display": "GMT-07:00", "name": "Mountain Time, US & Canada" }, { "timezone": "America/Ensenada", "offset": 28800, "display": "GMT-08:00", "name": "Tijuana, Baja California" }, { "timezone": "America/Los_Angeles", "offset": 28800, "display": "GMT-08:00", "name": "Pacific Time, US & Canada" }, { "timezone": "America/Anchorage", "offset": 32400, "display": "GMT-09:00", "name": "Alaska" }, { "timezone": "Etc/GMT+10", "offset": 36000, "display": "GMT-10:00", "name": "Hawaii" }, { "timezone": "Pacific/Midway", "offset": 39600, "display": "GMT-11:00", "name": "Midway Island, Samoa" }, { "timezone": "Etc/GMT+12", "offset": 43200, "display": "GMT-12:00", "name": "International Date Line West" } ] {% endresponse %} {% response xml %} Pacific/Tongatapu -46800 GMT+13:00 Nuku'alofa Pacific/Auckland -46800 GMT+12:00 Auckland, Wellington Etc/GMT-12 -43200 GMT+12:00 Fiji, Kamchatka, Marshall Is. Asia/Magadan -43200 GMT+12:00 Magadan Etc/GMT-11 -39600 GMT+11:00 Solomon Is., New Caledonia Asia/Vladivostok -39600 GMT+11:00 Vladivostok Asia/Yakutsk -36000 GMT+10:00 Yakutsk Australia/Brisbane -36000 GMT+10:00 Brisbane Australia/Sydney -39600 GMT+10:00 Canberra, Melbourne, Sydney Australia/Hobart -39600 GMT+10:00 Hobart Australia/Adelaide -37800 GMT+09:30 Adelaide Australia/Darwin -34200 GMT+09:30 Darwin Asia/Irkutsk -32400 GMT+09:00 Irkutsk, Ulaan Bataar Asia/Tokyo -32400 GMT+09:00 Osaka, Sapporo, Tokyo Asia/Seoul -32400 GMT+09:00 Seoul Asia/Hong_Kong -28800 GMT+08:00 Beijing, Chongqing, Hong Kong, Urumqi Asia/Krasnoyarsk -28800 GMT+08:00 Krasnoyarsk Australia/Perth -28800 GMT+08:00 Perth Asia/Taipei -28800 GMT+08:00 Taipei Asia/Bangkok -25200 GMT+07:00 Bangkok, Hanoi, Jakarta Asia/Novosibirsk -25200 GMT+07:00 Novosibirsk Asia/Rangoon -23400 GMT+06:30 Yangon Rangoon Asia/Dhaka -21600 GMT+06:00 Astana, Dhaka Asia/Yekaterinburg -21600 GMT+06:00 Ekaterinburg Asia/Katmandu -20700 GMT+05:45 Kathmandu Asia/Kolkata -19800 GMT+05:30 Chennai, Kolkata, Mumbai, New Delhi Asia/Tashkent -18000 GMT+05:00 Asia/Tashkent Asia/Kabul -16200 GMT+04:30 Kabul Asia/Dubai -14400 GMT+04:00 Abu Dhabi, Muscat Asia/Baku -14400 GMT+04:00 Baku Europe/Moscow -14400 GMT+04:00 Moscow, St. Petersburg, Volgograd Asia/Tbilisi -14400 GMT+04:00 Tbilisi Asia/Yerevan -14400 GMT+04:00 Yerevan Asia/Tehran -12600 GMT+03:30 Tehran Asia/Baghdad -10800 GMT+03:00 Baghdad Europe/Minsk -10800 GMT+03:00 Kaliningrad, Minsk Asia/Kuwait -10800 GMT+03:00 Kuwait, Riyadh Africa/Addis_Ababa -10800 GMT+03:00 Nairobi Asia/Amman -7200 GMT+02:00 Amman Europe/Bucharest -7200 GMT+02:00 Athens, Bucharest Asia/Beirut -7200 GMT+02:00 Beirut Africa/Cairo -7200 GMT+02:00 Cairo Asia/Damascus -7200 GMT+02:00 Damascus Africa/Blantyre -7200 GMT+02:00 Harare, Pretoria Europe/Helsinki -7200 GMT+02:00 Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius Europe/Istanbul -7200 GMT+02:00 Istanbul Asia/Jerusalem -7200 GMT+02:00 Jerusalem Europe/Nicosia -7200 GMT+02:00 Nicosia Europe/Amsterdam -3600 GMT+01:00 Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna Europe/Belgrade -3600 GMT+01:00 Belgrade, Bratislava, Budapest, Prague, Ljubljana Europe/Brussels -3600 GMT+01:00 Brussels, Copenhagen, Madrid, Paris Europe/Warsaw -3600 GMT+01:00 Sarajevo, Skopje, Warsaw, Zagreb Africa/Algiers -3600 GMT+01:00 West Central Africa Africa/Windhoek -7200 GMT+01:00 Windhoek Africa/Casablanca 0 GMT-00:00 Casablanca Etc/UTC 0 GMT-00:00 Coordinated Universal Time Africa/Abidjan 0 GMT-00:00 Monrovia, Reykjavik Europe/London 0 GMT-00:00 Dublin, Lisabon, London, Edinburgh Atlantic/Cape_Verde 3600 GMT-01:00 Cape Verde Is. Atlantic/Azores 3600 GMT-01:00 Azores America/Noronha 7200 GMT-02:00 Mid-Atlantic Etc/GMT+2 7200 GMT-02:00 Coordinated Universal Time - 02 America/Sao_Paulo 7200 GMT-03:00 Brasilia America/Argentina/Buenos_Aires 10800 GMT-03:00 Buenos Aires America/Cayenne 10800 GMT-03:00 Cayenne, Fortalenza America/Godthab 10800 GMT-03:00 Greenland America/Montevideo 7200 GMT-03:00 Montevideo America/St_Johns 12600 GMT-03:30 Newfoundland America/Asuncion 10800 GMT-04:00 Asuncion America/Goose_Bay 14400 GMT-04:00 Atlantic Time, Goose Bay America/Glace_Bay 14400 GMT-04:00 Atlantic Time, Canada America/Cuiaba 10800 GMT-04:00 Cuiaba America/La_Paz 14400 GMT-04:00 Georgetown, La Paz, Manaus, San Juan America/Santiago 10800 GMT-04:00 Santiago America/Caracas 16200 GMT-04:30 Caracas America/Bogota 18000 GMT-05:00 Bogota, Lima, Quito, Rio Branco America/New_York 18000 GMT-05:00 Eastern Time, US & Canada America/Havana 18000 GMT-05:00 Cuba America/Indiana/Indianapolis 18000 GMT-05:00 Indiana (East) America/Belize 21600 GMT-06:00 Central America America/Chicago 21600 GMT-06:00 Central Time, US & Canada America/Cancun 21600 GMT-06:00 Guadalajara, Mexico City, Monterrey Canada/Saskatchewan 21600 GMT-06:00 Saskatchewan America/Dawson_Creek 25200 GMT-07:00 Arizona America/Chihuahua 25200 GMT-07:00 Chihuahua, La Paz, Mazatlan America/Denver 25200 GMT-07:00 Mountain Time, US & Canada America/Ensenada 28800 GMT-08:00 Tijuana, Baja California America/Los_Angeles 28800 GMT-08:00 Pacific Time, US & Canada America/Anchorage 32400 GMT-09:00 Alaska Etc/GMT+10 36000 GMT-10:00 Hawaii Pacific/Midway 39600 GMT-11:00 Midway Island, Samoa Etc/GMT+12 43200 GMT-12:00 International Date Line West {% endresponse %} {% endapiexample %}