---
title: "List My Promotions"
method: GET
path: "/v1/users/me/promotions"
tags: ["promo"]
---

# List My Promotions

`GET /v1/users/me/promotions`

## Request

- Base URL: `https://api.superdocs.app`
- URL: `https://api.superdocs.app/v1/users/me/promotions`
- Auth: HTTP bearer

List the authenticated user's promotion redemptions, split into `active` (drawable now)
and `history` (exhausted / expired / revoked).

Used by the Settings → Billing tab to render the Credits & Promotions section.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- UserPromotionsResponse: Listing of the authenticated user's promotion grants, split by active vs. history.
  - `active` ActivePromotionOut[], required
    - `redemption_id` string, required
    - `name` string, required
    - `ops_granted` integer, required
    - `ops_remaining` integer, required
    - `redeemed_at` string, required
    - `expires_at` string, nullable, required
  - `history` HistoricalPromotionOut[], required
    - `redemption_id` string, required
    - `name` string, required
    - `ops_granted` integer, required
    - `ops_remaining` integer, required
    - `redeemed_at` string, required
    - `expires_at` string, nullable, required
    - `status` 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)