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

# List card expiring points buckets

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

<Info>

<Badge color="gray">Documentation in progress</Badge>

This documentation is in progress. The parameters, fields, request and response bodies, and other data may be subject to change. If you need more information or you want to share feedback, contact [Voucherify support](https://www.voucherify.io/contact-support) or your Technical Account Manager.

</Info>

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.

## Path parameters

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

## Query parameters

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

## Response `200`

Cursor-paginated list of points expiration buckets.

- CardPointsBucketListResponse — Cursor-paginated list of points expiration buckets.
  - `data` CardPointsBucket[], required — Points expiration buckets on the current page.
    - `id` string, required — Unique points expiration bucket ID.
    - `card_id` string, required — ID of the card the bucket belongs to.
    - `customer_id` string, required — ID of the customer owning the card.
    - `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 points in the bucket.
    - `expiration_date` string, date, required — Date when the points in the bucket expire (`YYYY-MM-DD`).
    - `expiration_type` 'NO_EXPIRATION' | 'ROLLING_EXPIRATION' | 'CALENDAR_EXPIRATION' | 'SLIDING_EXPIRATION', required — Points expiration type from the card definition.
    - `status` 'ACTIVE' | 'DELETED' | 'EXPIRED', 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_points_bucket', required — Object type marker, always `card_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 — 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/69be73b5cff0/schema)