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

## Request

- Base URL: `https://api.voucherify.io`
- URL: `https://api.voucherify.io/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/expiring-points`
- Auth: none required

<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 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` unknown
- `order` union
  - string[]
  - 'expiration_date' | '-expiration_date'
- `cursor` unknown

## 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, required: Timestamp when the bucket was last updated (ISO 8601), or null.
    - `object` string, required: Object type marker, always `card_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` string, 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.dev/voucherifyio/apis/voucherify-api-async-actions.md) - [All operations](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions/llms.txt) - [OpenAPI document](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions/revisions/4982266e0494?raw)