---
title: "Redeem set points for a missing common or rare"
method: POST
path: "/api/collectible-sets/{setId}/redeem"
tags: ["Collectibles"]
---

# Redeem set points for a missing common or rare

`POST /api/collectible-sets/{setId}/redeem`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/collectible-sets/{setId}/redeem`
- Auth: HTTP bearer

Authenticated. Spends set points on one missing common or rare member of the set. The card is added to the fan's primary wallet (source set_redeem) and that wallet's default binder when one exists. Epic, legendary, and mythic cards are NOT_REDEEMABLE. The same idempotencyKey replays the stored receipt.

## Path parameters

- `setId` string, required

## Request body

- object
  - `collectibleId` string, required
  - `idempotencyKey` string, required

## Response `200`

{ alreadyRecorded, pointsDelta, pointsBalance, setId, collectibleId, quantity, ownedAfter, set, reward }. pointsDelta is negative. set.newlyCompleted is true when this redeem finished the set.

- object
  - `success` true, required
  - `data` SetPointMutation, required
    - `alreadyRecorded` boolean, required: True when this idempotency key replayed a stored receipt.
    - `pointsDelta` integer, required: Positive on trade-in, negative on redeem. Never zero.
    - `pointsBalance` integer, required
    - `setId` string, required
    - `collectibleId` string, required
    - `quantity` integer, required
    - `ownedAfter` integer, required: Copies of this card the fan holds after the mutation.
    - `set` object, required
      - `setId` string, required
      - `owned` integer, required
      - `total` integer, required
      - `missingCollectibleIds` string[], required
      - `completed` boolean, required
      - `newlyCompleted` boolean, required
    - `reward` object, nullable, required: Set when this call granted the cosmetic badge. Null otherwise.
      - `rewardId` string, required
      - `title` string, required

## Other responses

- `400`: VALIDATION_ERROR for a bad body. NOT_REDEEMABLE when the card is not common or rare.
- `401`: Authentication required (UNAUTHORIZED)
- `404`: Collectible set not found or inactive (NOT_FOUND)
- `409`: ALREADY_OWNED, INSUFFICIENT_SET_POINTS, or IDEMPOTENCY_KEY_CONFLICT.

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/collectible-sets/:setId/redeem/post.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
