Timestamp Formatting

This article details the timestamp formatting for requests and responses.

Requests

We follow FDX standards for the date format in request parameters.

Data format: [YYYY]-[MM]-[DD]

Example input: 2019-02-26

The startTime and endTime query parameters for endpoints that use these parameters follow the ISO8601 date format. The parameters only require the date for the string.

Criteria for startTime and endTime query parameters:

• Do not include the time. The APIs only require the calendar date.

• Pad single digits with leading zeros, as date values require a fixed number of digits. For example, You enter 2 as 02.

• Data type is string

• A time range requires both a startTime and endTime.

Responses

After you submit your request, the API passes its response back to you as-is. APIs may use any format within the ISO8601 standard, so the exact timestamp in response payloads varies. Your implementation should take this into account through customization per API or by using a code library for dates.

Returned Timestamp Examples

• 2021-07-15T14:46:41.375Z

• 2019-09-16T00:00:00.000+0000

• 2022-01-31T05:00:00Z

• 2021-08-09