---
title: "Redeem customer points"
method: POST
path: "/v2/customers/{id}/redemptions"
---

# Redeem customer points

`POST /v2/customers/{id}/redemptions`

Redeem points for a customer from their individual or group wallet.

## Path parameters

- `id` integer, required

## Headers

- `Authorization` string
- `X-CAP-API-OAUTH-TOKEN` string

## Request body

- object
  - `redemptionType` string, required
  - `points` number, required
  - `transactionNumber` string, required
  - `validationCode` string
  - `source` string, required
  - `commit` boolean, required
  - `skipValidation` boolean
  - `groupRedemption` boolean
  - `externalReferenceNumber` string
  - `notes` string

## Response `201`

Successful redemption

- object
  - `entity` object
    - `redemptionId` string
    - `userId` integer
    - `points` number
    - `remainingPoints` number
    - `redeemed` boolean
    - `isGroupRedemption` boolean
    - `crossMemberRedemptionBreakup` object[]
      - `memberId` integer
      - `pointsRedeemed` number
      - `expiryDate` string
  - `warnings` object[]
  - `errors` object[]
  - `success` boolean

## Other responses

- `400` — Validation error — invalid customer ID or missing required field
- `401` — Unauthorized — invalid or missing credentials
- `500` — Internal server error

---

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