---
title: "Convert Promised Points"
method: POST
path: "/points/unlockPromisedPoints"
---

# Convert Promised Points

`POST /points/unlockPromisedPoints`

Convert promised points and alternate currencies to redeemable points.

## Query parameters

- `identifierName` string, required
- `identifierValue` string, required
- `source` string, required
- `type` 'USERGROUP2' | 'CUSTOMER'

## Request body

- object
  - `eventName` 'GenericEvent' | 'CustomerPromotionImport' | 'TargetCompleted' | 'LineitemsPointsPromotionImport' | 'BillPointsPromotionImport' | 'TransactionAdd' | 'GroupTransactionAdd', required — Name of the event to associate with unlock of promise points
  - `billNumber` string, required — Unique bill number of the transaction
  - `eventLogId` integer — Unique log ID of the current event.
  - `lineItemIds` integer[] — Array of the lineitems
  - `itemCodes` string[] — Array of the item code
  - `billDate` string, date — Date and time of the transaction in the ISO 8601 format - YYYY-MM-DDTHH:MM:SSZ
  - `sourceStoreId` integer — Store id
  - `sourceTilId` integer — Till id
  - `sourceProgramId` integer — Program Id

## Response `200`

200

- object
  - `pointsUnlocked` object[]
    - `billNumber` string
    - `pointsUnlocked` string
    - `programId` integer
  - `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)