Skip to content

List the reviews a member received

GET
/reviews/user/{user_id}
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. The list is not paginated: limit caps its length. Works without an access token.

user_id
required
integer

Example

4242

Identifier of the member.

as
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

Maximum number of reviews returned.

The reviews.

Media typeapplication/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
id

Unique identifier of the review.

integer
url_key
string
nullable
role

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

integer
Allowed values: 1 2
order_id

Order the review is about.

integer
nullable
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

A member of the marketplace (a buyer, a vendor, or both). Returned for the signed-in member by GET /auth/me and POST /account/create, and as the customer or the vendor of a review or an order.

object
object

A member of the marketplace, as the Front API returns it.

string
id

Unique identifier of the member.

integer
external_id

Identifier of the member in your own system, if you set one.

string
nullable
account_type

Legal form of the member.

string
nullable
Allowed values: individual company soletrader non_profit
first_name
string
nullable
last_name
string
nullable
username
string
nullable
public_name

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

string
business_name
string
nullable
email
string format: email
avatar

URL of the member’s profile picture.

string format: uri
nullable
birthday
string format: date
nullable
nationality

Country code.

string
nullable
lang

Preferred language of the member.

string
nullable
locale

Same value as lang.

string
nullable
timezone
string
nullable
phone_country_code
string
nullable
phone_number
string
nullable
address_line1
string
nullable
address_line2
string
nullable
address_city
string
nullable
address_zipcode
string
nullable
address_state
string
nullable
address_country

Country code.

string
nullable
company

Company details. Absent when account_type is individual.

object
object
string
name

Same value as the member’s business_name.

string
nullable
number

Company registration number.

string
nullable
website_url
string
nullable
address_line1
string
nullable
address_line2
string
nullable
address_city
string
nullable
address_zipcode
string
nullable
address_state
string
nullable
address_country
string
nullable
group

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

object
object
string
id
integer
nullable
name

Name of the group.

string
nullable
alias

Handle of the group.

string
nullable
group_id

Use group.id.

integer
nullable
group_name

Use group.name.

string
nullable
group_alias

Use group.alias.

string
nullable
can_post_listing

Whether the member’s group may publish listings.

boolean
is_onboarding

Whether the member’s group is an onboarding group.

boolean
status

Whether the account is active.

string
Allowed values: enabled disabled unknown
identity_status

Progress of the member’s identity verification. Read-only: the member cannot change it.

string
nullable
Allowed values: not_completed completed
attributes

Values of the custom member fields defined by the marketplace, keyed by field alias. A value is a string, or a list for multiple-choice fields.

object
key
additional properties
any
metafields

Custom data attached to the member, grouped by namespace then keyed by title: {"namespace": {"title": "value"}}. null when the member has none.

object
key
additional properties
object
key
additional properties
any
listing_count

Number of the member’s listings online.

integer
nullable
listing_count_any_status

Number of the member’s listings, whatever their status.

integer
average_rating

Average rating received in reviews.

number
nullable
review_count

Number of reviews received.

integer
nullable
profile_url

Public profile page of the member on the marketplace.

string format: uri
created_at

Registration date, as YYYY-MM-DD HH:MM:SS.

string
nullable
supplier

A member of the marketplace (a buyer, a vendor, or both). Returned for the signed-in member by GET /auth/me and POST /account/create, and as the customer or the vendor of a review or an order.

object
object

A member of the marketplace, as the Front API returns it.

string
id

Unique identifier of the member.

integer
external_id

Identifier of the member in your own system, if you set one.

string
nullable
account_type

Legal form of the member.

string
nullable
Allowed values: individual company soletrader non_profit
first_name
string
nullable
last_name
string
nullable
username
string
nullable
public_name

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

string
business_name
string
nullable
email
string format: email
avatar

URL of the member’s profile picture.

string format: uri
nullable
birthday
string format: date
nullable
nationality

Country code.

string
nullable
lang

Preferred language of the member.

string
nullable
locale

Same value as lang.

string
nullable
timezone
string
nullable
phone_country_code
string
nullable
phone_number
string
nullable
address_line1
string
nullable
address_line2
string
nullable
address_city
string
nullable
address_zipcode
string
nullable
address_state
string
nullable
address_country

Country code.

string
nullable
company

Company details. Absent when account_type is individual.

object
object
string
name

Same value as the member’s business_name.

string
nullable
number

Company registration number.

string
nullable
website_url
string
nullable
address_line1
string
nullable
address_line2
string
nullable
address_city
string
nullable
address_zipcode
string
nullable
address_state
string
nullable
address_country
string
nullable
group

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

object
object
string
id
integer
nullable
name

Name of the group.

string
nullable
alias

Handle of the group.

string
nullable
group_id

Use group.id.

integer
nullable
group_name

Use group.name.

string
nullable
group_alias

Use group.alias.

string
nullable
can_post_listing

Whether the member’s group may publish listings.

boolean
is_onboarding

Whether the member’s group is an onboarding group.

boolean
status

Whether the account is active.

string
Allowed values: enabled disabled unknown
identity_status

Progress of the member’s identity verification. Read-only: the member cannot change it.

string
nullable
Allowed values: not_completed completed
attributes

Values of the custom member fields defined by the marketplace, keyed by field alias. A value is a string, or a list for multiple-choice fields.

object
key
additional properties
any
metafields

Custom data attached to the member, grouped by namespace then keyed by title: {"namespace": {"title": "value"}}. null when the member has none.

object
key
additional properties
object
key
additional properties
any
listing_count

Number of the member’s listings online.

integer
nullable
listing_count_any_status

Number of the member’s listings, whatever their status.

integer
average_rating

Average rating received in reviews.

number
nullable
review_count

Number of reviews received.

integer
nullable
profile_url

Public profile page of the member on the marketplace.

string format: uri
created_at

Registration date, as YYYY-MM-DD HH:MM:SS.

string
nullable

Example

{
"reviews": [
{
"id": 4242,
"role": 1,
"status": 0,
"note": "4.50",
"customer": {
"object": "User",
"id": 4242,
"account_type": "individual",
"first_name": "Jane",
"last_name": "Doe",
"public_name": "Jane D.",
"email": "jane@example.com",
"birthday": "1990-04-12",
"nationality": "FR",
"lang": "fr",
"locale": "fr",
"timezone": "Europe/Paris",
"phone_country_code": "33",
"phone_number": "612345678",
"address_line1": "12 rue de la Paix",
"address_city": "Paris",
"address_zipcode": "75002",
"address_country": "FR",
"company": {
"object": "Company"
},
"group": {
"object": "Group",
"id": 12,
"name": "Vendors",
"alias": "vendors"
},
"status": "enabled",
"identity_status": "not_completed",
"attributes": {
"profession": "Photographer"
},
"average_rating": 4.5,
"profile_url": "https://acme.mykreezalid.com/s/a1b2c3d/jane-d",
"created_at": "2026-10-01 09:30:00"
},
"supplier": {
"object": "User",
"id": 4242,
"account_type": "individual",
"first_name": "Jane",
"last_name": "Doe",
"public_name": "Jane D.",
"email": "jane@example.com",
"birthday": "1990-04-12",
"nationality": "FR",
"lang": "fr",
"locale": "fr",
"timezone": "Europe/Paris",
"phone_country_code": "33",
"phone_number": "612345678",
"address_line1": "12 rue de la Paix",
"address_city": "Paris",
"address_zipcode": "75002",
"address_country": "FR",
"company": {
"object": "Company"
},
"group": {
"object": "Group",
"id": 12,
"name": "Vendors",
"alias": "vendors"
},
"status": "enabled",
"identity_status": "not_completed",
"attributes": {
"profession": "Photographer"
},
"average_rating": 4.5,
"profile_url": "https://acme.mykreezalid.com/s/a1b2c3d/jane-d",
"created_at": "2026-10-01 09:30:00"
}
}
]
}