---
title: "Update Points Expiry"
method: POST
path: "/points/updateExpiry"
---

# Update Points Expiry

`POST /points/updateExpiry`

Updates expiry dates for points based on customer identifier and transaction reference data.

## Headers

- `Authorization` string, required
- `X-CAP-API-AUTH` string
- `Content-Type` 'application/json'
- `Accept` 'application/json'

## Request body

- PointsExpiryUpdateRequest
  - `expiryDateUpdateRequest` PointsExpiryUpdateRequestItem[], required — List of expiry update requests
    - `identifierName` 'mobile' | 'email' | 'customerId' | 'externalId' | 'id', required — Customer identifier type (e.g., 'mobile', 'email', 'customerId', 'externalId', 'id')
    - `identifierValue` string, required — Customer identifier value
    - `programId` integer, required — Loyalty program identifier
    - `pointsAwardedRefId` integer, required — Reference ID of the points transaction
    - `pointsAwardedRefType` 'POINT_AWARDED' | 'POINT_AWARDED_BILL_PROMOTION' | 'POINT_AWARDED_LINEITEM' | 'POINT_AWARDED_LINEITEM_PROMOTION' | 'POINT_AWARDED_CUSTOMER_PROMOTION', required — Type of points award reference
    - `currencyName` string — Name of the points currency (e.g., 'Main')
    - `pointCategoryType` 'REGULAR' | 'PROMISED' — Category of points
    - `expiryUpdateReasonType` string — Type of expiry update (e.g., 'EARLY_EXPIRY', 'EXTEND_EXPIRY')
    - `expiryUpdateReasonNote` string — Reason for updating expiry date
    - `standardMeta` StandardMeta
      - `who_raised` string
      - `who_approved` string
      - `reason_for_trigger` string
    - `customMeta` CustomMeta — Custom metadata fields
    - `expiryDate` ExpiryDate, required
      - `expiryType` 'FIXED_DATE' | 'FIXED_DAYS' | 'FIXED_MONTHS' | 'IMMEDIATE', required — Type of expiry
      - `expiryValue` string, required — Value for expiry (date string or number of days/months)

## Response `200`

Successful response

- PointsExpiryUpdateSuccessResponse
  - `entity` PointsExpiryUpdateSuccessEntity
    - `updateCurrencyExpiryDateResponse` UpdateCurrencyExpiryDateResponseItem[]
      - `customerId` integer
      - `programId` integer
      - `success` boolean
    - `failures` object[]
  - `errors` ErrorDetail[]
    - `code` integer
    - `message` string
  - `warnings` ErrorDetail[]
    - `code` integer
    - `message` string

## Other responses

- `400` — Bad Request - Validation failed

---

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