Request parameter
Value
Required or optional
Default            
Endpoints
Authentication required 
sort
enum
Optional
-updated_date
reviews
No

sort specifies which fields are used for sorting the results. Multiple comma separated values can be assigned to the parameter, with each value immediately preceded by a plus or minus (+ or -) indicating the sort order, + indicating largest number (or oldest) first, - indicating smallest number (or most recent) first. Multiple sort values can be applied to a single API call but when done, the first value is preceded by the applicable + or - but any further values must be preceded with their encoded equivalent of + (%2B) or - (%2D). See the example below.

Possible values are:

  • created_date
    The date the feedback was submitted by the customer. Valid in the following modes:
    • mode = all
    • mode = service
    • mode = product
    • mode = nps
  • updated_date
    The date the feedback was most recently updated (i.e. when the customer updated their review by adding further comments or changing their originally submitted rating). Valid in the following modes:
    • mode = all
    • mode = service
    • mode = product
    • mode = nps
  • helpful
    The number of helpful votes the review has received. For 'mode = all' and 'mode = service', this relates to service reviews; for 'mode = product', this relates to product reviews. Valid in the following modes:
    • mode = all
    • mode = service
    • mode = product
  • id
    The service feedback id (based on reviews[].service.id). Valid in the following modes:
    • mode = all
    • mode = service

An example Reviews API call using sort is:

https://api.feefo.com/api/version/reviews/all?merchant_identifier=example-retail-merchant&sort=-created_date,%2Bhelpful

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.
  • sort = the fields the results are sorted on. In this example, the results will initially be sorted by 'created_date', the most recent first (indicated by the -), and then sorted by 'helpful', the most helpful first (indicated by the %2B which is the encoding for +).

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

Reviews API Parameter: full_threadReviews API Parameter: page_size