/api/v1/mystery/redemption/:purchase_id packs:readEvery redemption for a card, newest first (404 when none). The path accepts a purchase id OR an on-chain token id (token-first redemptions carry purchase_id: null). Fill in either input below. Status: PREPARED → BURN_SUBMITTED → IN_FULFILLMENT → COMPLETED, or FAILED / CANCELLED / EXPIRED.
GET /api/v1/mystery/redemption/ These inputs are shared across all docs pages — an id entered here carries over.
Not run yet — press Run to make a live call against https://service.rip.fun (through this demo's server-side proxy; the API key never reaches the browser).
curl -X GET 'https://service.rip.fun/api/v1/mystery/redemption/' \ -H 'X-API-Key: rip_…'
| Field | Type | Required | Description |
|---|---|---|---|
verify | query bool | — | true → check the card’s status live on-chain instead of cached |
data)| Field | Description |
|---|---|
redemptions[].purchase_id | null for token-first (own-gacha) redemptions |
redemptions[].status | Lifecycle status (see overview); failure_reason set when FAILED |
redemptions[].burn | db_status, is_burned (flips when the item ships), burn_type + label (REDEEM_CARD…) |
redemptions[].queue / order | Redeem-queue + fulfillment order status (tracking_number once shipped) |
redemptions[].burn_tx_hash / shipping_quote / expires_at | Recorded burn tx, locked-in rate, and when the transaction expires |
| Status | Code | When |
|---|---|---|
| 404 | not_found | no redemptions exist for the purchase or token |
See Errors for the response envelope and the full code list.