Partners
API referenceEndpointsRedemption

Check packaging groups before requesting a quote

POST
/shipping-groups

Optional preview for a selection of owned prizes. Send exactly one of prizeId and prizeIds. The quote remains authoritative for destination eligibility and cost.

Authorization

WalletSession
headerAuthorizationBearer <token>

Authorization: Bearer <accessToken> from POST /auth/verify. Proves control of one wallet for one hour. Used only by the Redemption endpoints, from the browser.

Request Body

application/json
  1. body

Exactly one of prizeId and prizeIds.

prizeId?integer
Range1 <= value
prizeIds?array<>
Items1 <= items <= 50

Response Body

Packaging preview in data.groups; no payment or shipment is created.

Example Request
curl -X POST 'https://api-staging.theverity.xyz/api/v1/redeem/shipping-groups' \  -H 'Authorization: Bearer <wallet_access_token>' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
Empty