List invitations
Review invitations from Invitation History with status, type, email, order ID and send date.
MCP tool reviews_io_read → list_invitations
read
Returns invitations as Invitation History lists them, for email or SMS. status is in_progress, paused, sent or responded. A paused invitation carries the reason REVIEWS.io shows when you hover over Paused. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | in_progress, paused, sent or responded. |
| invite_type enum | enum | email or sms. |
| email string | string | Customer email address. |
| order_id string | string | Order ID the invitation was queued for. |
| date_from date | date | Start of the date range. |
| date_to date | date | End of the date range. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "reviews_io_read",
"arguments": {
"operation": "list_invitations",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invitations": [
{
"invitation_id": "9120456",
"type": "email",
"status": "in_progress",
"email": "a.novak@example.com",
"order_id": "77410",
"send_date": "2026-10-24"
},
{
"invitation_id": "9120457",
"type": "email",
"status": "in_progress",
"email": "l.mora@example.com",
"order_id": "77411",
"send_date": "2026-10-24"
},
{
"invitation_id": "9120460",
"type": "sms",
"status": "in_progress",
"email": "j.tran@example.com",
"order_id": "77412",
"send_date": "2026-10-25"
}
],
"next_cursor": null
},
"isError": false
}