{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Redemption Redeem — Error Reference"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"redemption-redeem--error-reference","__idx":0},"children":["Redemption Redeem — Error Reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page lists every error response your application can receive when redeeming a reward"," ","(",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /redemptions/redeems"]},") and when reading redemption-redeem status"," ","(",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /redemptions/redeems/me"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /redemptions/redeems"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /redemptions/redeems/{redeemId}"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the general error envelope, categories, and client-handling patterns, see the"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/8.error-handling"},"children":["Error Handling guide"]}," — this page only covers what's specific to redeeming."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-format","__idx":1},"children":["Response format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every error is a JSON object with an HTTP status code matching the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," field:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"status\": 409,\n  \"title\": \"You have a redemption currently being processed (ID: 6e2c..., status: PROCESSING). Please wait for it to complete.\",\n  \"detail\": \"You have a redemption currently being processed (ID: 6e2c..., status: PROCESSING). Please wait for it to complete.\",\n  \"message\": \"You have a redemption currently being processed (ID: 6e2c..., status: PROCESSING). Please wait for it to complete.\",\n  \"code\": \"REDEMPTION_ALREADY_PROCESSING\",\n  \"category\": \"DOMAIN_RULE\",\n  \"retryable\": false,\n  \"domain\": \"business\",\n  \"timestamp\": \"2026-08-24T10:00:00.000Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," for programmatic handling — don't parse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]},"/",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]},"/",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["detail"]},", their wording can"," ","change. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retryable: true"]}," means the same request is safe to retry unmodified after a short delay;"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retryable: false"]}," means the request needs to change before it can succeed (or the situation needs"," ","to resolve on its own, e.g. waiting for an in-progress redemption to finish)."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"using-the-explorinspers-sdk","__idx":2},"children":["Using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@explorins/pers-sdk"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you're on the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.pers.ninja/sdk-intro"},"children":["PERS SDK"]}," rather than calling the REST API"," ","directly, redemption calls go through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sdk.redemptions.*"]}," and surface the same error codes wrapped"," ","in the SDK's own error classes (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.pers.ninja/sdk-intro#error-handling"},"children":["SDK Error Handling"]},"):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"import { PersApiError, AuthenticationError } from \"@explorins/pers-sdk/core\";\n\ntry {\n  const result = await sdk.redemptions.redeem({ redemptionId: \"redemption-123\" });\n} catch (error) {\n  if (error instanceof AuthenticationError) {\n    // 401 — redirect to login\n  } else if (error instanceof PersApiError) {\n    // The SDK passes the full backend structured error through onto the thrown\n    // instance — not just status/message: error.code, error.category, error.domain,\n    // error.retryable, and error.details all map 1:1 to the tables below.\n    console.error(\"Redemption failed:\", error.code, error.status, error.category, error.retryable);\n  }\n}\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"post-redemptionsredeems--execute-a-redemption","__idx":3},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /redemptions/redeems"]}," — Execute a redemption"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"HTTP"},"children":["HTTP"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"code"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Retryable"},"children":["Retryable"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it means"},"children":["What it means"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to do"},"children":["What to do"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTHENTICATION_REQUIRED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You're not signed in, or your session doesn't identify a user."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sign the user in and retry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVALID_TOKEN"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TOKEN_EXPIRED"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TOKEN_REVOKED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your access token is invalid, expired, or revoked."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refresh the token (or re-authenticate), then retry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTHORIZATION_FAILED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The user account is not active."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reactivate the account, or contact support."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RESOURCE_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redemptionId"]}," doesn't exist."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the ID and retry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VALIDATION_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The redemption needs a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["businessId"]}," you didn't provide, or another required input is malformed/missing. Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," for which field."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fix the request and retry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REQUIRED_FIELDS_MISSING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The user's profile is missing information this redemption requires (e.g. email, date of birth). See ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.missingFields"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Prompt the user to complete their profile, then retry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_REQUIREMENT_NOT_MET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The user doesn't have a qualifying booking for this redemption. See ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.requirementType"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Prompt the user to make/complete a qualifying booking, then retry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USER_STATUS_RESTRICTED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The user's account status/tier is too low for this redemption."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not actionable by retry — inform the user of the required tier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USER_NOT_FOUND"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WALLET_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The user or their wallet could not be resolved."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rare/unexpected — contact support if it persists."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INSUFFICIENT_BALANCE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The user doesn't have enough token balance to pay for this redemption."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Prompt the user to top up, then retry. Nothing was created/charged."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LOCATION_VERIFICATION_REQUIRED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This redemption has a country restriction and we couldn't determine the user's location."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ensure location data is sent with the request, then retry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GEOGRAPHIC_RESTRICTION"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This redemption isn't available in the user's country."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not actionable by retry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["409"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REDEMPTION_ALREADY_PROCESSING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The user already has a redemption for this item in progress."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Don't retry immediately — poll the redemption's status instead (see below) and let it finish."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["409"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MAX_REDEMPTION"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This redemption has run out of total supply."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not actionable by retry — inform the user it's sold out."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["409"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USER_LIMIT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The user has already redeemed this item the maximum number of times allowed."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not actionable by retry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WALLET_MISSING_SIGNING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The user's wallet needs a one-time signing-account setup before it can transact."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Complete wallet/signing setup for the user, then retry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BUSINESS_NOT_MINTER"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The business isn't authorized to send this reward token."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact support/admin to authorize the business as a minter."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SYSTEM_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An unexpected error occurred while processing the transaction (e.g. temporary network/RPC issue). The redemption attempt was marked as failed — no funds/tokens were left in an inconsistent state."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Safe to retry after a short delay. If it keeps happening, contact support with the timestamp."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409 REDEMPTION_ALREADY_PROCESSING"]}]},": this is expected behavior for double-submits"," ","(e.g. a user double-tapping \"Redeem\"), not necessarily an error state. Debounce the redeem button"," ","client-side, and if you do receive this code, poll ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /redemptions/redeems/{redeemId}"]}," (using the"," ","ID from the error) instead of resubmitting."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-redemptionsredeemsme--get-redemptionsredeems--get-redemptionsredeemsredeemid","__idx":4},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /redemptions/redeems/me"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /redemptions/redeems"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /redemptions/redeems/{redeemId}"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"HTTP"},"children":["HTTP"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"code"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it means"},"children":["What it means"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to do"},"children":["What to do"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTHENTICATION_REQUIRED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You're not signed in, or (on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/{redeemId}"]},") the redeem doesn't belong to the signed-in user."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sign in, or don't request redeems that aren't the current user's."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RESOURCE_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["On ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/{redeemId}"]},": the ID doesn't exist."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the ID and retry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VALIDATION_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["On admin list queries: you filtered by both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userId"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["businessId"]}," at once (not supported — use one or the other)."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fix the request and retry."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"details-payload-reference","__idx":5},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]}," payload reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some errors include a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]}," object with extra structured data:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"code"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"details shape"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]}," shape"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example"},"children":["Example"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REQUIRED_FIELDS_MISSING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ missingFields: string[] }"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ \"missingFields\": [\"email\", \"dateOfBirth\"] }"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_REQUIREMENT_NOT_MET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ requirementType: string }"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ \"requirementType\": \"active\" }"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REDEMPTION_ALREADY_PROCESSING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(none — the redeem ID and status are embedded in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]},")"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quick-reference--all-codes-for-this-flow-by-http-status","__idx":6},"children":["Quick reference — all codes for this flow, by HTTP status"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"HTTP"},"children":["HTTP"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Codes"},"children":["Codes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VALIDATION_ERROR"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LOCATION_VERIFICATION_REQUIRED"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTHENTICATION_REQUIRED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVALID_TOKEN"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TOKEN_EXPIRED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TOKEN_REVOKED"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTHORIZATION_FAILED"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RESOURCE_NOT_FOUND"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USER_NOT_FOUND"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WALLET_NOT_FOUND"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["409"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REDEMPTION_ALREADY_PROCESSING"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MAX_REDEMPTION"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USER_LIMIT"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REQUIRED_FIELDS_MISSING"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INSUFFICIENT_BALANCE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WALLET_MISSING_SIGNING"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_REQUIREMENT_NOT_MET"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USER_STATUS_RESTRICTED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GEOGRAPHIC_RESTRICTION"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BUSINESS_NOT_MINTER"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SYSTEM_ERROR"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the underlying error envelope, categories, and general client-side handling patterns, see the"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/8.error-handling"},"children":["Error Handling guide"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-documentation","__idx":7},"children":["Related documentation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.pers.ninja/8.error-handling"},"children":["PERS Error Handling"]}," — response envelope, categories, correlation IDs"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.pers.ninja/5.authentication-guide"},"children":["PERS Authentication Guide"]}," — the 401/403 auth errors referenced above"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.pers.ninja/sdk-intro"},"children":["PERS SDK Introduction"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sdk.redemptions.*"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PersApiError"]},"/",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AuthenticationError"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.pers.ninja/sdk-reference/readme"},"children":["PERS SDK Reference"]}," — full generated API reference"]}]}]},"headings":[{"value":"Redemption Redeem — Error Reference","id":"redemption-redeem--error-reference","depth":1},{"value":"Response format","id":"response-format","depth":2},{"value":"Using the @explorins/pers-sdk","id":"using-the-explorinspers-sdk","depth":2},{"value":"POST /redemptions/redeems — Execute a redemption","id":"post-redemptionsredeems--execute-a-redemption","depth":2},{"value":"GET /redemptions/redeems/me , GET /redemptions/redeems , GET /redemptions/redeems/{redeemId}","id":"get-redemptionsredeemsme--get-redemptionsredeems--get-redemptionsredeemsredeemid","depth":2},{"value":"details payload reference","id":"details-payload-reference","depth":2},{"value":"Quick reference — all codes for this flow, by HTTP status","id":"quick-reference--all-codes-for-this-flow-by-http-status","depth":2},{"value":"Related documentation","id":"related-documentation","depth":2}],"frontmatter":{"seo":{"title":"Redemption Redeem — Error Reference"}},"lastModified":"2026-08-24T16:05:41.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/redemption-redeem-errors","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}