---
title: "Redeem Gift Code"
method: POST
path: "/api/gifts/redeem"
tags: ["gifts"]
---

# Redeem Gift Code

`POST /api/gifts/redeem`

Redeem a gift code to receive 1 year of premium access.

The premium access is stacked on top of any existing subscription.
Users cannot redeem their own gift codes.

Args:
    request: RedeemGiftCodeRequest with the gift code

Returns:
    RedeemGiftCodeResponse with success status and message

## Headers

- `x-user-id` string, nullable

## Request body

- RedeemGiftCodeRequest — Request model for redeeming a gift code
  - `code` string, required — The gift code to redeem

## Response `200`

Successful Response

- RedeemGiftCodeResponse — Response model for redeeming a gift code
  - `success` boolean, required — Whether the redemption was successful
  - `message` string, required — Success or error message

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/usecreed/apis/creed-api.md) · [All operations](https://skmtc.net/usecreed/apis/creed-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usecreed/creed-api/revisions/cb25d3fef898/schema)