---
title: "List Loyalty Card Point Expiration"
method: GET
path: "/v1/loyalties/{campaignId}/members/{memberId}/points-expiration"
tags: ["Loyalties"]
---

# List Loyalty Card Point Expiration

`GET /v1/loyalties/{campaignId}/members/{memberId}/points-expiration`

Retrieve loyalty point expiration buckets for a given loyalty card. Expired point buckets are not returned in this endpoint. You can use the [Exports API](/api-reference/exports/create-export) to retrieve a list of both `ACTIVE` and `EXPIRED` point buckets.

## Query parameters

- `limit` integer
- `page` integer

## Response `200`

Returns a list of loyalty points expiration buckets along with an expiration date if the points are due to expire. No expiration date parameter is returned if the loyalty points bucket does not expire.

- LoyaltiesMembersPointsExpirationListResponseBody — Response body schema for **GET** `v1/loyalties/{campaignId}/members/{memberId}/points-expiration`.
  - `object` 'list', required — The type of the object represented by JSON. This object stores information about loyalty points expiration buckets in a dictionary.
  - `data_ref` 'data', required — Identifies the name of the attribute that contains the array of loyalty points expiration bucket objects.
  - `data` LoyaltyPointsBucket[], required — Contains array of loyalty points expiration buckets.
    - `id` string, required — Unique identifier of the loyalty points bucket.
    - `voucher_id` string, required — Unique identifier of the parent loyalty card.
    - `campaign_id` string, required — Unique identifier of the parent campaign.
    - `bucket` object, required — Defines the number of points stored in this loyalty point bucket.
      - `total_points` integer, required — Total number of points in the loyalty point bucket.
    - `status` string, required — Loyalty point bucket status.
    - `expires_at` string, date, required — Date when the number of points defined in the bucket object are due to expire.
    - `created_at` string, date-time, required — Timestamp representing the date and time when the loyalty point bucket object was created in ISO 8601 format.
    - `updated_at` string, date-time — Timestamp representing the date and time when the loyalty point bucket object was updated in ISO 8601 format.
    - `object` 'loyalty_points_bucket', required — The type of the object represented by JSON. This object stores information about the loyalty point bucket.
  - `total` integer, required — Total number of point expiration buckets.

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-api-async-actions/revisions/4982266e0494/schema)