---
title: "Update redeem points"
method: PUT
path: "/points/updateRedemption"
---

# Update redeem points

`PUT /points/updateRedemption`

## Request body

- object
  - `redemptionId` string, required — A unique identifier for the redemption process.
  - `externalReferenceNumber` string, required — Unique reference number associated with the bill.
  - `billNumber` string — A string identifier for the bill.
  - `billId` integer — A numerical identifier for the bill. The maximum number of supported characters is 19.
  - `purpose` string — The purpose or reason for the redemption update.
  - `type` 'CUSTOMER' | 'USER GROUP' — The type of entity involved in the transaction.
  - `identifierValue` string — The value of the identifier for the entity.
  - `customFields` object — Object containing details of custom fields for the point redemption.
  - `key` string — Key-value pairs of the custom field and its respective value.

## Response `200`

200

- object
  - `id` integer
  - `programId` integer
  - `pointsRedeemed` integer
  - `billId` integer
  - `billNumber` string
  - `validationCode` string
  - `notes` string
  - `redemptionTime` integer
  - `pointsRedemptionTime` integer
  - `tillId` integer
  - `tillName` string
  - `pointDeductionList` unknown[]
    - unknown
  - `redemptionId` string
  - `customFields` object[]
    - `name` string
    - `value` string
  - `customerId` integer
  - `redemptionPurpose` string
  - `redemptionDate` string
  - `warnings` unknown[]
    - unknown

## Other responses

- `400` — 400

---

[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)