List reviews
Reviews of your shop with rating, product, status, sentiment and whether a reply exists.
GET https://cotlet.dev/api/v1/judge-me/reviews
read
Lists reviews in the order the Reviews dashboard shows them, with next_cursor for the next page. It uses the dashboard filters, so has_reply and sentiment work here although the REST API cannot filter by them. review_id is the ID for get_review, reply_to_review, publish_review and hide_review. status is the dashboard status: to_curate reviews wait for a decision, and Judge.me publishes them after 14 days if nobody moderates them.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | published, to_curate (pending), hidden or archived. Default: all statuses. |
| rating integer | integer | Only reviews with this star rating, 1 to 5. |
| sentiment enum | enum | positive, neutral or negative, as the Reviews dashboard classifies them. |
| has_reply boolean | boolean | true for reviews with a reply, false for reviews without one. |
| product string | string | Product title or handle. |
| since date | date | Only reviews created on or after this date. |
| limit integer | integer | Reviews per page. Default: 20. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/judge-me/reviews \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("judge-me", "list_reviews")const result = await cotlet.call('judge-me', 'list_reviews');cotlet call judge-me list_reviewsExample response
{
"reviews": [
{
"review_id": 48210934,
"rating": 4,
"title": "Fits well",
"body": "Warm and light. Runs slightly small.",
"product": "Trail Jacket",
"reviewer": "Dana K.",
"status": "published",
"verified": true,
"sentiment": "positive",
"has_reply": false,
"source": "email",
"created_at": "2026-10-21T09:12:00Z"
},
{
"review_id": 48199021,
"rating": 1,
"title": "Great deals at cheapwatch.example",
"body": "Visit cheapwatch.example for 70% off.",
"product": "Trail Jacket",
"reviewer": "Sam",
"status": "to_curate",
"verified": false,
"sentiment": "neutral",
"has_reply": false,
"source": "web",
"created_at": "2026-10-20T16:40:00Z"
}
],
"next_cursor": "2"
}