List card pending points buckets

curl --request GET \
  --url {protocol}://{host}/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/pending-points \
  --header 'Authorization: Bearer <token>' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>'

{
  "data": [
    {
      "id": "<string>",
      "card_id": "<string>",
      "card_definition_id": "<string>",
      "program_id": "<string>",
      "card_type": "INDIVIDUAL",
      "member_id": "<string>",
      "points": {
        "total": 123
      },
      "date": "2023-12-25",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "object": "<string>"
    }
  ],
  "cursor": {
    "next": "<string>",
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "object": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

List card pending points buckets

BETA endpoint

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.

Returns a cursor-paginated list of pending points buckets of the member’s card. Pending points are earned points waiting for activation (period-based, fixed-dates or event-based activation, per the card definition’s pending points settings). Results can be ordered by activation date. Returns 404 when the program, member or card does not exist.

GET

loyalties

programs

{programId}

members

{memberId}

cards

{cardId}

pending-points

List card pending points buckets

curl --request GET \
  --url {protocol}://{host}/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/pending-points \
  --header 'Authorization: Bearer <token>' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>'

{
  "data": [
    {
      "id": "<string>",
      "card_id": "<string>",
      "card_definition_id": "<string>",
      "program_id": "<string>",
      "card_type": "INDIVIDUAL",
      "member_id": "<string>",
      "points": {
        "total": 123
      },
      "date": "2023-12-25",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "object": "<string>"
    }
  ],
  "cursor": {
    "next": "<string>",
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "object": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

X-App-Id

string

header

required

X-App-Token

string

header

required

Path Parameters

programId

string

required

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

Pattern: ^lprg_[a-f0-9]+$

memberId

string

required

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

Pattern: ^lmbr_[a-f0-9]+$

cardId

string

required

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

Pattern: ^lcrd_[a-f0-9]+$

Query Parameters

limit

integer | null

default:10

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

Required range: 1 <= x <= 100

order

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

Available options:

date,

-date

cursor

string | null

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

Pattern: ^lcrscppb_[a-f0-9]+$

Response

Cursor-paginated list of pending points buckets.

data

object[]

required

Pending points buckets on the current page.

Show child attributes

cursor

object | null

required

Pagination cursor, or null when there are no more results.

Show child attributes

object

string

required

Object type marker, always list.

Allowed value: "list"

Last modified on July 27, 2026

List card activities Activate a pending points bucket

⌘I

Card Definitions

Programs

Members

Examine

Earning Rules

Tier Structures

Benefits

Rewards

List card pending points buckets

Authorizations

Path Parameters

Query Parameters

Response