List redemptions

GET /api/v1/mystery/redemptions packs:read

History of every redemption across your end-users (same shape as the per-card status endpoint). Optional ?status= filter.

Try it GET /api/v1/mystery/redemptions?limit=10

Limit

These inputs are shared across all docs pages, so an id entered here carries over.

response

403 14ms preloaded server-side with the default context

object · 3 keys

{
  "success": false,
  "message": "Mystery partner API key required",
  "error": "This endpoint requires an API key linked to a mystery partner account"
}

tracks the inputs above

curl -X GET 'https://service.rip.fun/api/v1/mystery/redemptions?limit=10' \
  -H 'X-API-Key: rip_…'

Request fields

Field	Type	Required	Description
`status`	query string	—	PREPARED \| BURN_SUBMITTED \| IN_FULFILLMENT \| COMPLETED \| FAILED \| CANCELLED \| EXPIRED
`limit / offset`	query int	—	Pagination

Errors

Status	Code	When
400	`invalid_status`	?status= is not a lifecycle status

See Errors for the response envelope and the full code list.