Fee lines for shipping a prize to an address
WalletSessionAuthorizationBearer <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.
application/json- body
Exactly one of prizeId and prizeIds.
prizeId?integerOne prize.
prizeIds?array<integer>Up to 50 distinct prizes held by the same wallet, including mixed product types.
1 <= items <= 50address*Preserve building, unit and street information. Street lines are reflowed for DHL without dropping details; together they must fit into at most three 45-character carrier lines without splitting words. Address fields can pass individual length limits yet fail this combined check. Return validation messages to the user; do not silently truncate their address.
options[], one per DHL product, each with packages (weight in kg, dimensions in cm, and zero-based itemIndexes), insuredValueUsd (sum of all selected item values), productCode, shippingFeeUsd, insuranceFeeUsd (the insurance part of shippingFeeUsd, already inside it; null when DHL itemises none), redemptionFeeUsd (2 USD per prize), totalFeeUsd (shipping plus that fee; one DHL quote covers every package in the shipment) and estDutiesTaxesUsd (estimated import charges, excluded from totalFeeUsd and collected separately by DHL; null means unavailable, not zero). Malaysia uses Verity’s configured customs-category rates and whole-shipment CIF value (items, shipping and insurance without double-counting insurance). With the configurable RM500 exemption enabled, eligible shipments at or below the threshold are exempt from import duty and sales tax; excise still applies regardless of amount. Rates and exemptions can change: display the returned estimate rather than calculating it on the client. Actual customs charges can differ.
curl -X POST 'https://api-staging.theverity.xyz/api/v1/redeem/quote' \ -H 'Authorization: Bearer <wallet_access_token>' \ -H 'Content-Type: application/json' \ -d '{ "address": { "recipientName": "string", "recipientEmail": "user@example.com", "recipientPhone": "string", "addressLine1": "string", "city": "string", "countryCode": "st" }}'