API Reference / List the review queue
List the review queue
GET/api/v1/review
What is waiting for the customer's approval, each card carrying the exact verbs the API accepts for it.
curl -H "Authorization: Bearer $REVNU_API_TOKEN" "https://revnu.com/api/v1/review?status=pending&limit=50"Query
| Param | Meaning |
|---|---|
status |
pending or needs_revision. Default: both. |
limit |
1 to 100. Default 50. |
Response
{ "items": [card, …] }, newest first within priority band. A card:
{
"id": "k97…",
"kind": "approval",
"sourceType": "gmail_draft",
"status": "pending",
"title": "Reply to Priya at Acme",
"prompt": "…",
"summary": "…",
"priority": "high",
"options": null,
"textInput": null,
"budgetChange": null,
"payload": { "…": "the draft, the research; long text capped at 8 KB" },
"actions": ["send", "snooze", "dismiss"],
"primaryLabel": "Send Reply",
"autoResolveAt": 1758326400000,
"dueAt": null, "snoozedUntil": null,
"leadId": "…", "postId": null,
"createdAt": 1758240000000, "updatedAt": 1758240000000, "resolvedAt": null
}Drive your UI from actions and primaryLabel. See Build a Review Screen.
Agents: this page is also markdown at /docs/review-list.md, answers Accept: text/markdown, and is listed in /docs/llms.txt.
Frequently Asked Questions
`review:read`. A token without it gets `403` with `requiredScope` in the body. `GET /me` shows a token's scopes.