v18

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01934981.1 MB

Programs

Expire a points bucket

<Badge color="yellow">BETA endpoint</Badge>

This is a work-in-progress documentation of a BETA endpoint. The parameters, fields, request and response bodies, and other data may subject to change. If you want to share feedback or improvements, contact Voucherify support or your Technical Account Manager.

</Warning>

Manually expires a points bucket before its scheduled expiration date, creating an ADMIN_POINTS_EXPIRATION card transaction (status PENDING, processed asynchronously). No request body.

The program and member must be in ACTIVE status, the card definition must have points expiration enabled, the bucket must be in ACTIVE status, and the bucket's expiration date must not be in the past (423 otherwise). Returns 404 when the program, member, card or bucket does not exist.

post/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/expiring-points/{bucketId}/expire

Path parameters

programIdstring required

Loyalty program ID (format lprg_[a-f0-9]+).

memberIdstring required

Program member ID (format lmbr_[a-f0-9]+).

cardIdstring required

Loyalty card ID (format lcrd_[a-f0-9]+).

bucketIdstring required

Points expiration bucket ID (format lcpeb_[a-f0-9]+).

Response

Result of the points expiration.

status'TRANSACTION_CREATED' | 'NO_EXPIRATION' required

Result status. The API endpoint returns TRANSACTION_CREATED.

messagestring required

Human-readable result message - "Points expiration transaction created".