/api/v1/mystery/redemption/quote cards:redeemPre-checkout shipping quote for redeeming a revealed item physically. Validates the address with Shippo and returns the cheapest live rate. Creates NO rows — safe to call to show shipping cost before the user commits.
POST /api/v1/mystery/redemption/quote write These inputs are shared across all docs pages — an id entered here carries over.
{
"purchase_id": 0,
"shipping_address": {
"name": "Demo Buyer",
"street1": "1 Market St",
"city": "San Francisco",
"state": "CA",
"zip": "94105",
"country": "US"
}
}Not run yet — press Run to make a live call against https://staging-service.rip.fun (through this demo's server-side proxy; the API key never reaches the browser).
curl -X POST 'https://staging-service.rip.fun/api/v1/mystery/redemption/quote' \
-H 'X-API-Key: rip_v1_…' \
-H 'Content-Type: application/json' \
-d '{"purchase_id":0,"shipping_address":{"name":"Demo Buyer","street1":"1 Market St","city":"San Francisco","state":"CA","zip":"94105","country":"US"}}' | Field | Type | Required | Description |
|---|---|---|---|
purchase_id | number | yes | The fulfilled purchase holding the item |
token_id | string | — | Required when the purchase revealed multiple items |
shipping_address.name | string | yes | Recipient full name |
shipping_address.street1 | string | yes | Street line 1 (`street2` optional) |
shipping_address.city | string | yes | City |
shipping_address.state | string | — | State / region |
shipping_address.zip | string | yes | Postal code |
shipping_address.country | string | yes | ISO country code, e.g. `US` (`phone`, `email` optional) |
data)| Field | Description |
|---|---|
shipping_quote.amount_usdc | Quoted shipping cost (USD decimal string) |
shipping_quote.carrier / service | Cheapest live Shippo rate, e.g. USPS Ground Advantage |
shipping_quote.estimated_days | Carrier transit estimate |
shipping_quote.rate_id / quoted_at | Shippo rate object id + quote timestamp |
| Status | Code | When |
|---|---|---|
| 400 | missing_shipping_address | shipping_address omitted or incomplete |
| 400 | invalid_address | Shippo cannot validate the address |
| 400 | token_required | multi-item purchase without token_id |
| 409 | not_fulfilled | purchase has not revealed yet |
See Errors for the response envelope and the full code list.