---
title: "List card pending point buckets"
method: GET
path: "/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/pending-points"
tags: ["Programs"]
---

# List card pending point buckets

`GET /v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/pending-points`

## Request

- Base URL: `https://api.voucherify.io`
- URL: `https://api.voucherify.io/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/pending-points`
- Auth: one of:
  - API key in header `X-App-Id` and API key in header `X-App-Token`
  - HTTP bearer

Returns a cursor-paginated list of pending point buckets for the member's card. Every bucket has status `PENDING`. Pending points wait for activation (`PERIOD_BASED`, `FIXED_DATES`, or `EVENT_BASED`), following the card definition.

The list starts on the next project day. The current day's bucket is omitted because it's still accumulating.

Results can be filtered by card definition ID and ordered by `date`.

Returns `404` when the program or the member doesn't exist, or when the card isn't assigned to that member.

Bucket IDs from this list are the `bucketId` for [Activate pending point bucket](/api-reference/programs/activate-pending-point-bucket) and [Cancel pending point bucket](/api-reference/programs/cancel-pending-point-bucket).

## Query parameters

- `limit` integer, nullable
- `order` union
  - string[]
  - 'date' | '-date'
- `cursor` string, nullable
- `filters` V2LoyaltiesProgramsMembersCardsPendingPointsListRequestQuery
  - `junction` 'AND' | 'OR', nullable: Joins the field filters. Allowed values are `AND` and `OR`. Defaults to `AND`.
  - `card_definition_id` CardDefinitionIdFilterConditions: ID conditions. Format `lcdef_[a-f0-9]+`. At least one condition is required.
    - `conditions` object, required
      - `$is` union: Matches one value. A string or a one-element array. Format `lcdef_[a-f0-9]+`.
        - string
        - string[]
      - `$is_not` union: Excludes one value. A string or a one-element array. Format `lcdef_[a-f0-9]+`.
        - string
        - string[]
      - `$in` union: Matches any of the values. A string or an array of 1 to 100 values. Format `lcdef_[a-f0-9]+`.
        - string
        - string[]
      - `$not_in` union: Excludes any of the values. A string or an array of 1 to 100 values. Format `lcdef_[a-f0-9]+`.
        - string
        - string[]

## Response `200`

Cursor-paginated list of pending point buckets.

- V2LoyaltiesProgramsMembersCardsPendingPointsListResponseBody: Cursor-paginated list of pending point buckets.
  - `data` CardPendingPointsBucket[], required: Pending point buckets on the current page.
    - `card_id` string, required: ID of the card the bucket belongs to.
    - `card_definition_id` string, required: ID of the card definition of the card.
    - `program_id` string, required: ID of the loyalty program.
    - `member_id` string, required: ID of the member owning the card.
    - `card_type` 'INDIVIDUAL', required: Card type. Currently, only `INDIVIDUAL` is supported.
    - `created_at` string, date-time, required: Timestamp when the bucket was created (ISO 8601).
    - `updated_at` string, date-time, nullable, required: Timestamp when the bucket was last updated (ISO 8601), or `null`.
    - `id` string, required: Unique pending point bucket ID.
    - `points` object, required: Points held in the bucket.
      - `total` number, required: Number of pending points in the bucket.
    - `date` string, date, required: Scheduled activation date of the pending points (`YYYY-MM-DD`). For the `EVENT_BASED` type this is the cancellation deadline.
    - `type` 'PERIOD_BASED' | 'FIXED_DATES' | 'EVENT_BASED', required: Pending points activation type from the card definition.
    - `status` 'PENDING' | 'ACTIVATED' | 'CANCELED' | 'DELETED', required: Bucket status.
    - `object` 'card_pending_points_bucket', required: Object type marker, always `card_pending_points_bucket`.
  - `cursor` ListCursor, required: Pagination cursor.
    - `next` string, required: Cursor value to pass as the `cursor` query parameter to fetch the next page.
    - `expires_at` string, date-time, required: Timestamp when the cursor expires.
  - `object` 'list', required: Object type marker, always `list`.

## Other responses

- `400`: The query failed validation, the cursor is invalid or expired, or the cursor doesn't match the query.
- `404`: Resource not found.
- `500`: Internal server error.

## Changes

- **2026-10-15** (v2) `4134cde57cda`: 1 breaking, 1 info
  - removed the required property `allOf[#/components/schemas/CardPendingPointsListResponse]/data/items/allOf[subschema #2]/card_type` from the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardPendingPointsListResponse]/data/items/allOf[#/components/schemas/CardBucketBase]/card_type` to the response with the `200` status
- **2026-10-14** (v2) `0d886da710c9`: 1 breaking, 1 info
  - removed the required property `allOf[#/components/schemas/CardPendingPointsListResponse]/data/items/allOf[#/components/schemas/CardBucketBase]/card_type` from the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardPendingPointsListResponse]/data/items/allOf[subschema #2]/card_type` to the response with the `200` status
- **2026-10-14** (v2) `f53d017a25d6`: 1 breaking, 1 info
  - removed the required property `allOf[#/components/schemas/CardPendingPointsListResponse]/data/items/allOf[subschema #2]/card_type` from the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardPendingPointsListResponse]/data/items/allOf[#/components/schemas/CardBucketBase]/card_type` to the response with the `200` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/changes/v2/loyalties/programs/:programId/members/:memberId/cards/:cardId/pending-points/get.md)

---

[API](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api.md) - [All operations](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/revisions/e0d9f2d2532f?raw)