---
title: "Redeem Promo"
method: POST
path: "/v1/promo/redeem"
tags: ["promo"]
---

# Redeem Promo

`POST /v1/promo/redeem`

## Request

- Base URL: `https://api.superdocs.app`
- URL: `https://api.superdocs.app/v1/promo/redeem`
- Auth: HTTP bearer

Redeem a promo code and add the granted operations to the authenticated user's account.

B2C only: web app login tokens and sk_ user API keys are accepted; lce_ org keys are rejected.
Requires a verified email. Each user may redeem a given code at most once.

Rate-limited to 3 attempts per IP per hour. All attempts (success and failure) are
logged for audit.

## Headers

- `authorization` string, nullable

## Request body

- RedeemRequest: Redeem a promo code and receive its credit grant.
  - `code` string, required: The promo code (case-insensitive).

## Response `201`

Successful Response

- RedeemResponse: Response body for POST /v1/promo/redeem on success.
  - `status` string: Always 'redeemed' on success.
  - `promotion` RedemptionOut, required: Summary of a successful redemption, returned from POST /v1/promo/redeem.
    - `id` string, required
    - `name` string, required
    - `ops_granted` integer, required
    - `ops_remaining` integer, required
    - `redeemed_at` string, required
    - `expires_at` string, nullable, required
  - `message` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/superdocs/apis/universal-document-ai-api.md) · [All operations](https://skmtc.dev/superdocs/apis/universal-document-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superdocs/apis/universal-document-ai-api/revisions/37d03122940b?raw)