/api/v1/mystery/purchase/:purchase_id packs:read Poll this after a purchase to track it: SUBMITTED → FULFILLED (or REFUNDED / FAILED). Once FULFILLED it includes the opened items with full card details (name, image_url, value_usd).
GET /api/v1/mystery/purchase/0 These inputs are shared across all docs pages, so 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/purchase/0' \ -H 'X-API-Key: rip_…'
data)| Field | Description |
|---|---|
status | SUBMITTED → FULFILLED, or REFUNDED / FAILED |
custody | How the pack was paid for, uppercase: "CUSTODIAL" (from the end-user’s CardOS wallet balance) or "NON_CUSTODIAL" (the end user signed and paid from their own wallet) |
tier_id / quantity | Which tier was bought, and how many packs (always 1 today) |
price / price_usdc / volume_usdc | What the pack cost: integer USDC micros as a string, plus the decimal twins for display |
onchain_request_id / transaction_hash / purchaser_address | reveal request, purchase tx and the paying wallet, once on-chain |
failure_reason | Why a FAILED or REFUNDED purchase ended that way; null otherwise |
reserved_at / submitted_at / fulfilled_at / created_at | Lifecycle timestamps; each is null until that step happens |
items[].token_id / item_type | Revealed NFT. Feed token_id into price / buyback / redemption |
items[].card_id | Canonical Card Data id (graded slabs resolved too) — join the pull straight onto the card catalog. Null for products and unmapped tokens |
items[].name / image_url / value_usd / rarity / card_number / set_id | Hydrated card metadata |
memo | "{partner-slug}-{purchase_id}" per-key attribution tag. Absent entirely when your key has no slug — check for the key, don’t expect null |
| Status | Code | When |
|---|---|---|
| 404 | not_found | purchase_id does not belong to this partner |
See Errors for the response envelope and the full code list.