GET /v1/reviews
Visible reviews about a buyer or a seller
secret key only
curl https://api.marketsdk.com/v1/reviews \
-H "Authorization: Bearer $MARKETSDK_KEY"200 example response, review list
{
"object": "list",
"data": [
{
"object": "review",
"id": "rev_034XtPDs7UJ0TXzTsdaHZa",
"order": "string",
"author_role": "buyer",
"author": "string",
"subject": "string",
"visible": false,
"rating": null,
"body": null,
"removed": false,
"created_at": "2026-10-01T12:00:00.000Z"
}
],
"has_more": false,
"next_cursor": null
}parameters
| field | type | about |
|---|---|---|
| limit | integer, in query | min 1, max 100, default 20 |
| starting_after | string, in query | The next_cursor of the previous page. |
| subjectrequired | string, in query | The buyer or seller the reviews are about. |
returns 200, review list
fields
| field | type | about |
|---|---|---|
| objectrequired | one of: list | |
| datarequired | array of review | |
| data[].objectrequired | one of: review | |
| data[].idrequired | string | |
| data[].orderrequired | string | |
| data[].author_rolerequired | one of: buyer, seller | |
| data[].authorrequired | string | |
| data[].subjectrequired | string | |
| data[].visiblerequired | boolean | False until both parties have reviewed or the review window has closed. Rating and body are withheld until then. |
| data[].ratingrequired | integer or null | min 1, max 5 |
| data[].bodyrequired | string or null | |
| data[].removedrequired | boolean | Removed by moderation. A removed review stops counting toward reputation. |
| data[].created_atrequired | timestamp | |
| has_morerequired | boolean | Whether another page follows. |
| next_cursorrequired | string or null | Pass as starting_after (or cursor for search) to get the next page. |
errors
- 400The request is not valid.
- 401No API key, or not a valid one.
- 429Rate limited. See
Retry-After.