List the reviews a member received

GET

/reviews/user/{user_id}

const url = 'https://acme.mykreezalid.com/front_api/v1/reviews/user/4242?as=vendor&limit=25';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://acme.mykreezalid.com/front_api/v1/reviews/user/4242?as=vendor&limit=25'

Returns the public reviews about a member, newest first: by default the reviews the member received as a vendor, or with as=customer the reviews of the orders the member placed. Reviews written by the member are left out. Each party of a review comes as their public profile. The list is not paginated: limit caps its length. Works without an access token. An unknown member, or one hidden from visitors, has no reviews.

Parameters

Path Parameters

user_id

required

integer

Example

Identifier of the member.

Query Parameters

string

default: vendor

Allowed values: vendor customer

customer for the reviews about the member as a customer; any other value, or none, for the reviews about the member as a vendor.

limit

integer

default: 25 >= 1 <= 100

Maximum number of reviews returned, at most 100.

Responses

200

The reviews.

application/json

object

reviews

Array<object>

A review written after an order, by the customer about the vendor or by the vendor about the customer.

object

Unique identifier of the review.

integer

role

Who wrote the review: 1 the customer, 2 the vendor.

integer

Allowed values: 1 2

listing_id

Listing the review is about.

integer

nullable

user_id

Identifier of the member who wrote the review.

integer

nullable

customer_id

integer

nullable

supplier_id

Identifier of the vendor.

integer

nullable

status

0 waiting to be written, 3 completed, 9 expired.

integer

Allowed values: 0 3 9

is_public

boolean

double_blind

Whether the review stays hidden until the other party has reviewed too.

boolean

note

Rating, as a decimal number in a string.

string

review

Text of the review.

string

nullable

answer

Public answer of the reviewed member.

string

nullable

answer_at

string format: date-time

nullable

completed_at

string format: date-time

nullable

reviewed_at

string format: date-time

nullable

created

string format: date-time

modified

string format: date-time

customer

Public profile of the customer; null when the member is hidden from visitors.

object

object

Another member, as anyone may see them.

string

Unique identifier of the member.

integer

public_name

Name shown to other members, built from the member’s details according to the marketplace’s display settings.

string

avatar

URL of the member’s profile picture.

string format: uri

nullable

profile_url

Public profile page of the member on the marketplace.

string format: uri

nullable

group

The member group (type of account) the member belongs to.

object

object

string

integer

nullable

name

Name of the group.

string

nullable

alias

Handle of the group.

string

nullable

supplier

Public profile of the vendor; null when the member is hidden from visitors.

object

object

Another member, as anyone may see them.

string

Unique identifier of the member.

integer

public_name

Name shown to other members, built from the member’s details according to the marketplace’s display settings.

string

avatar

URL of the member’s profile picture.

string format: uri

nullable

profile_url

Public profile page of the member on the marketplace.

string format: uri

nullable

group

The member group (type of account) the member belongs to.

object

object

string

integer

nullable

name

Name of the group.

string

nullable

alias

Handle of the group.

string

nullable

Example

{
  "reviews": [
    {
      "id": 4242,
      "role": 1,
      "status": 0,
      "note": "4.50",
      "customer": {
        "object": "User",
        "id": 4242,
        "public_name": "Jane D.",
        "profile_url": "https://acme.mykreezalid.com/s/a1b2c3d/jane-d",
        "group": {
          "object": "Group",
          "id": 12,
          "name": "Vendors",
          "alias": "vendors"
        }
      },
      "supplier": {
        "object": "User",
        "id": 4242,
        "public_name": "Jane D.",
        "profile_url": "https://acme.mykreezalid.com/s/a1b2c3d/jane-d",
        "group": {
          "object": "Group",
          "id": 12,
          "name": "Vendors",
          "alias": "vendors"
        }
      }
    }
  ]
}