---
title: "Claim Referrer Reward"
method: POST
path: "/api/referrals/claim-reward"
tags: ["referrals"]
---

# Claim Referrer Reward

`POST /api/referrals/claim-reward`

Claim the referrer reward for a specific redemption.

This endpoint allows referrers to claim their 1 month premium reward
when someone uses their referral code. The reward is stacked on top
of any existing subscription.

Args:
    request: ClaimRewardRequest with the redemption_id

Returns:
    ClaimRewardResponse with success status and message

## Headers

- `x-user-id` string, nullable

## Request body

- ClaimRewardRequest — Request model for claiming referrer reward
  - `redemption_id` integer, required — The ID of the redemption record

## Response `200`

Successful Response

- ClaimRewardResponse — Response model for claiming referrer reward
  - `success` boolean, required — Whether the claim 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/523833f9e819/schema)