SOAP API time data storage and return

IMPORTANT  The SOAP API entered a limited enhancement phase in Q4 2020. Access to version 1.6 will be deactivated.

Note the following details regarding Autotask time data storage and return.

  • The Web Services API stores and returns all time data in Eastern Standard Time (EST), based on Microsoft’s EST standard. The Microsoft EST standard respects EDT (Eastern Daylight Time), also known as Daylight Saving Time. For an explanation of EDT, refer to timeanddate.com (external link).
  • In XML, the representation of Web Services API date-time values does not include a decimal point. Note that, for milliseconds only, trailing zeros do not appear.

NOTE  For example, 2019-07-18T18:29:45.100 will return as 2019-07-18T18:29:45.1.

  • An error will occur if the time falls within a range for the current time zone that does not map to Coordinated Universal Time (UTC) because of the application of an adjustment rule; for example, invalid times will occur when the time moves ahead for Daylight Saving Time. This issue only occurs for 'datetime' type fields that require timezone conversion.

Date and time formatting

  • To ensure correct date and time conversion via the API, submit date-time values in the format yyyy-mm-ddThh:mm:ss.ms. Date-time values will return in that format.