List redemptions
Store redemptions with item, viewer, cost and what the viewer filled in on the Requirements page.
GET https://cotlet.dev/api/v1/streamelements/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. |
Request
curl https://cotlet.dev/api/v1/streamelements/redemptions \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("streamelements", "list_redemptions")const result = await cotlet.call('streamelements', 'list_redemptions');cotlet call streamelements list_redemptionsExample response
{
"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
}