Timestamp formatting

Below is an explanation of the timestamp formatting Akoya expects in requests, and how timestamps are returned.

Requests

Akoya follows FDX standards for timestamps in requests.

The startTime and endTime query parameters for the Transactions endpoint must follow RFC 3339, an extension of the ISO8601 format requiring both the date and time in the string. The time should be in UTC:

  • Data type: string

  • Example input: 2019-02-26T00:00:00Z

  • When specifying a time range, both startTime and endTime must be used.

Responses

After you submit your request, Akoya will convert the timestamp to whichever ISO8601 format that provider utilizes then pass the request on to the provider. The response is then passed back to you as-is.

Providers may use any format within the ISO8601 standard, so the exact timestamp in response payloads will vary. Your implementation should take this into account through customization per provider 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

Change log

DateUpdate
2024-Sept-04Added intro.
2024-Aug-06Added dev help resources.
2022-Oct-24Original


Need help?

Check out our Developer Community, or visit the Support Center in the Data Recipient Hub.

Looking for provider nuance documentation?

All provider nuance documentation is available in the Data providers section in the Data Recipient Hub.

Still stuck?

For all production issues, submit a support ticket through the Data Recipient Hub. Our support team is standing by 24/7. Questions and non-production issues will be answered during business hours.