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 the encoded equivalent value of plus or minus (or -) indicating the sort order, indicating that the smallest number (or oldest) should be first (the encoded equivalent being %2B) or indicating that the largest number (or newest) should be first (the encoded equivalent being %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=%2Dcreated_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 newest first (indicated by the %2D which is the encoding for -), and then sorted by 'helpful', the least 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