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

Parameters: list_review_requests
NameTypeDescription
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
curl https://cotlet.dev/api/v1/judge-me/review-requests \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("judge-me", "list_review_requests")
Node.js
const result = await cotlet.call('judge-me', 'list_review_requests');
CLI
cotlet call judge-me list_review_requests

Example response

JSON

{
  "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
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.