List review requests
Review request emails with their status, customer, product and send date.
GET https://cotlet.dev/api/v1/judge-me/review-requests
read
Lists the requests on Reviews > Review requests, with next_cursor for the next page. request_id is the ID for send_review_request. source shows Manual for requests added by hand. A request for an unsubscribed email or with no email found carries that reason in status_note, and send_review_request cannot send it.
Parameters
| Name | Type | Description |
|---|---|---|
| status string | string | Status as the Review requests page filter names it: Sent, Will send, Will skip, Waiting for delivery and the others it lists. |
| search string | string | Customer email or order number. |
| 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/review-requests \
-H "Authorization: Bearer $COTLET_API_KEY" result = client.call("judge-me", "list_review_requests") const result = await cotlet.call('judge-me', 'list_review_requests'); cotlet call judge-me list_review_requests Example response
{
"requests": [
{
"request_id": "rr_7731",
"customer": "Dana K.",
"email": "dana.k@example.com",
"order": "#4790",
"product": "Trail Jacket",
"status": "Will send",
"status_note": "",
"source": "automatic",
"scheduled_for": "2026-10-24"
},
{
"request_id": "rr_7702",
"customer": "Marcus R.",
"email": "marcus.r@example.com",
"order": "#4776",
"product": "Camp Stove",
"status": "Will skip",
"status_note": "Unsubscribed email",
"source": "automatic",
"scheduled_for": "2026-10-22"
}
],
"next_cursor": null
}