REST v2 - Contacts - List Contacts - Date Format difference for the Update Time Filters

API Q&A
1

@OmarAlmonte, I need to report that there is a variation in the Date Time Format for the Contacts - List Contacts endpoint “start_update_time” and “end_update_time” filters.

I have been using the “Y-m-d\TH:i:s\Z” format in PHP for passing Date and Time to other endpoints. But when trying to the same for List Contacts endpoint it raised this error below.

Datetime: start/end_update_time is invalid, please provide a datetime that conforms to ISO8601 (Combined date and time, ie: 2017-07-20T17:00:00.000Z)

The format for this is “Y-m-d\TH:i:s.v\Z”, the “.v” has been added.

This is not mentioned in the documentation and is inconsistent with the date format for the other endpoints.

2

Hi,

Thanks for reporting this.

We’ll update the documentation to clarify that the start_update_time and end_update_time filters require the ISO 8601 format with milliseconds (YYYY-MM-DDTHH:mm:ss.SSSZ).

We don’t plan to address the inconsistency in v2, as changing this behavior could impact existing consumers.