v18

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

List card expiring points buckets

<Warning>

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

Returns a cursor-paginated list of points expiration buckets of the member's card. Each bucket groups active points sharing the same expiration date and expiration type. Results can be ordered by expiration_date. Returns 404 when the program, member or card does not exist.

get/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/expiring-points

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]+).

Query parameters

limitinteger nullable

Maximum number of buckets to return. Must be between 1 and 100. Defaults to 10 when not provided.

string[]
OR
'expiration_date' | '-expiration_date'

Field(s) to order results by. Valid orders are expiration_date and -expiration_date; defaults to expiration_date (soonest expiration first). Ordering by the same field in both directions simultaneously is rejected.

cursorstring nullable

Pagination cursor returned in the cursor.next field of a previous response. Must match the pattern ^lcrspeb_[a-f0-9]+$.

Response

Cursor-paginated list of points expiration buckets.

object'list' required

Object type marker, always list.