What format are timestamps in Allocadia API responses?

ISO-8601 with fractional seconds, always in UTC. Example: 2017-03-10T22:57:38.437Z.

All timestamps returned by the Allocadia REST API are in ISO-8601 format with fractional seconds, always in UTC.

Example: 2017-03-10T22:57:38.437Z

This format applies to:

• createdDate and updatedDate on every domain entity (except financials)
• All date-time values in API responses

Things to know

• The trailing Z indicates UTC (Zulu time). Your code should treat the timestamp as UTC and convert to local time only when displaying.
• Fractional seconds (.437 in the example) are included. If your parser doesn't accept fractional seconds, configure it for the ISO-8601 extended format.
• Date-only values (no time component) are formatted as yyyy-MM-dd — e.g. 2016-01-20 for a Cell with column type DATE.

Related articles

• The Allocadia REST API — overview of endpoints
• REST API authentication in Allocadia (bearer token, 20-minute timeout)
• Allocadia API requests returning HTTP 429 — too many requests