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

# List card pending points buckets

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

<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](https://www.voucherify.io/contact-support) or your Technical Account Manager.

</Warning>

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.

## Path parameters

- `programId` string, required
- `memberId` string, required
- `cardId` string, required

## Query parameters

- `limit` integer, nullable
- `order` union
  - string[]
  - 'date' | '-date'
- `cursor` string, nullable

## Response `200`

Cursor-paginated list of pending points buckets.

- CardPendingPointsBucketListResponse — Cursor-paginated list of pending points buckets.
  - `data` CardPendingPointsBucket[], required — Pending points buckets on the current page.
    - `id` string, required — Unique pending points bucket ID.
    - `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.
    - `card_type` 'INDIVIDUAL', required — Card type.
    - `member_id` string, required — ID of the member owning the card.
    - `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` 'IMMEDIATE' | 'PERIOD_BASED' | 'FIXED_DATES' | 'EVENT_BASED', required — Pending points activation type from the card definition.
    - `status` 'PENDING' | 'ACTIVATED' | 'CANCELED' | 'DELETED', required — Bucket status.
    - `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.
    - `object` 'card_pending_points_bucket', required — Object type marker, always `card_pending_points_bucket`.
  - `cursor` MemberListCursor, 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 — Timestamp when the cursor expires.
  - `object` 'list', required — Object type marker, always `list`.

## Other responses

- `400` — Validation error - request body or query parameters failed validation, or the operation is not allowed in the current resource state.
- `404` — Resource not found.
- `409` — Conflict - e.g. duplicate resource or invalid state transition.
- `500` — Internal server error.

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-loyalty-v2-api.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-loyalty-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-loyalty-v2-api/versions/f6f2f3388362/schema)