List redemptions
Store redemptions with item, viewer, cost and what the viewer filled in on the Requirements page.
MCP tool streamelements_read → list_redemptions
read
Returns store redemptions, filtered by item, viewer or status, like the Redemptions page. Details holds the answers a viewer gave to the item's Requirements page. History reaches back up to a year. Pass redemption_id to resolve_redemption.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | pending, approved or declined. Default: pending. |
| item string | string | Only redemptions of this item name. |
| viewer string | string | Only redemptions by this username. |
| limit integer | integer | 1 to 100. Default: 50. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "streamelements_read",
"arguments": {
"operation": "list_redemptions",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"redemptions": [
{
"redemption_id": "rd_91a0f3",
"item": "Pick my next game",
"viewer": "luka_dev",
"cost": 1500,
"details": "Hollow Knight",
"status": "pending",
"redeemed_at": "2026-10-16T19:42:00Z"
}
],
"next_cursor": null
},
"isError": false
}