Request parameter
Value
Required or optional
Default
Endpoints  Authentication required 
updated_date_time
string
Optional
None
summary, reviews No 

updated_date_time is used to filter the JSON feed to those reviews where the consumer has updated their review (i.e. added further comments or changed their original submitted rating) on a specified Coordinated Universal Time (UTC) date / time (time is optional, defaulting to 00:00:00 when not supplied). The format for updated_date_time is yyyy-mm-ddThh:mm:ss (e.g. 2015-10-25T12:45:10). 

Accepted query operators are:

  • =
    Filter data to show reviews updated on a precise date (time is ignored with this operator).
  • <
    Filter data to show reviews updated prior to the defined date / time. 
  • <=
    Filter data to show reviews updated either on or prior to the defined date / time.
  • >
    Filter data to show reviews updated since the defined date / time.
  • >=
    Filter data to show reviews updated either on or since the defined date and time.

Note: If using updated_date_time in conjunction with other parameters involving date and time, updated_date_time overrides the following:

However, updated_date_time is overridden by:

An example Reviews API call using updated_date_time is:

https://api.feefo.com/api/version/reviews/all?merchant_identifier=example-retail-merchant&updated_date_time=2016-08-22

Where:

  • version = the version of the API associated with the URL. See API Versions for the version number.
  • all = returns both service and product reviews.
  • merchant_identifier = the merchant's unique Feefo identifier, which in this example is example-retail-merchant.
  • updated_date_time = filter by this date. In this example only reviews updated on 22nd August 2016 will be passed to the feed.

Full details about the API can be found at Reviews API (Customisable Integration).

Reviews API Parameter: date_timeReviews API Parameter: since_period