---
title: "Changes to List card expiring points buckets"
method: GET
path: "/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/expiring-points"
---

# Changes to List card expiring points buckets

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 18 of 211 revisions.

- **2026-10-15** (v2) `4134cde57cda`: 1 breaking, 1 info
- **2026-10-14** (v2) `0d886da710c9`: 1 breaking, 1 info
- **2026-10-14** (v2) `f53d017a25d6`: 1 breaking, 1 info
- **2026-10-14** (v2) `d29b33490051`: 15 breaking, 1 warning, 1 info
- **2026-10-14** (v2) `be14b3318eb3`: 2 breaking, 15 info
- **2026-10-14** (v2) `6a418ac8b7b1`: 3 breaking, 1 info
- **2026-10-13** (v2) `f95b50556c93`: 4 info
- **2026-10-13** (v2) `9905dfce1d1e`: 3 breaking, 1 info
- **2026-10-13** (v2) `c59a345c733b`: 4 info
- **2026-10-13** (v2) `88a97345800f`: 3 breaking, 1 info
- **2026-10-09** (v2) `e2d0b0a800ba`: 1 info
- **2026-10-07** (v2) `338a5e34004e`: 2 info
- **2026-09-01** (v2) `a972e3958604`: 1 info
- **2026-08-28** (v2) `c148961ff7f7`: 1 info
- **2026-08-28** (v2) `4428c9d7f7ee`: 3 warning, 2 info
- **2026-07-31** (v2) `703a0a42ea43`: 1 breaking, 1 info
- **2026-07-17** (v2) `4cbaee5a82d5`: 8 info
- **2026-07-06** (v2) `341403eb19e5`: 15 breaking, 11 warning, 28 info

## Changes

- **2026-10-15** (v2) `4134cde57cda`: 1 breaking, 1 info
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/allOf[subschema #2]/card_type` from the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/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/CardExpiringPointsListResponse]/data/items/allOf[#/components/schemas/CardBucketBase]/card_type` from the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/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/CardExpiringPointsListResponse]/data/items/allOf[subschema #2]/card_type` from the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/allOf[#/components/schemas/CardBucketBase]/card_type` to the response with the `200` status
- **2026-10-14** (v2) `d29b33490051`: 15 breaking, 1 warning, 1 info
  - the `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/card_definition_id` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/card_id` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/card_type` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/created_at` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/customer_id` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/expiration_date` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/expiration_type` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/id` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/member_id` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/object` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/points` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/program_id` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/status` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/updated_at` from the response with the `200` status
  - for the `query` request parameter `filters`, the type of property `oneOf[subschema #1: V2 Loyalties Programs Members Cards Expiring Points List Request Query]/` changed from `object` to no type
  - added `#/components/schemas/CardBucketBase, subschema #2` to the `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/` response property `allOf` list for the response status `200`
- **2026-10-14** (v2) `be14b3318eb3`: 2 breaking, 15 info
  - for the `query` request parameter `filters`, the type of property `oneOf[subschema #1: V2 Loyalties Programs Members Cards Expiring Points List Request Query]/` was specialized from no type to `object`
  - the `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/` response's property type changed from no type to `object` for status `200`
  - removed `#/components/schemas/CardBucketBase, subschema #2` from the `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/` response property `allOf` list for the response status `200`
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/card_definition_id` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/card_id` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/card_type` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/created_at` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/customer_id` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/expiration_date` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/expiration_type` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/id` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/member_id` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/object` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/points` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/program_id` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/status` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardExpiringPointsListResponse]/data/items/updated_at` to the response with the `200` status
- **2026-10-14** (v2) `6a418ac8b7b1`: 3 breaking, 1 info
  - removed the required property `cursor` from the response with the `200` status
  - removed the required property `data` from the response with the `200` status
  - removed the required property `object` from the response with the `200` status
  - added `#/components/schemas/CardExpiringPointsListResponse` to the response body `allOf` list for the response status `200`
- **2026-10-13** (v2) `f95b50556c93`: 4 info
  - removed `#/components/schemas/CardExpiringPointsListResponse` from the response body `allOf` list for the response status `200`
  - added the required property `cursor` to the response with the `200` status
  - added the required property `data` to the response with the `200` status
  - added the required property `object` to the response with the `200` status
- **2026-10-13** (v2) `9905dfce1d1e`: 3 breaking, 1 info
  - removed the required property `cursor` from the response with the `200` status
  - removed the required property `data` from the response with the `200` status
  - removed the required property `object` from the response with the `200` status
  - added `#/components/schemas/CardExpiringPointsListResponse` to the response body `allOf` list for the response status `200`
- **2026-10-13** (v2) `c59a345c733b`: 4 info
  - removed `#/components/schemas/CardExpiringPointsListResponse` from the response body `allOf` list for the response status `200`
  - added the required property `cursor` to the response with the `200` status
  - added the required property `data` to the response with the `200` status
  - added the required property `object` to the response with the `200` status
- **2026-10-13** (v2) `88a97345800f`: 3 breaking, 1 info
  - removed the required property `cursor` from the response with the `200` status
  - removed the required property `data` from the response with the `200` status
  - removed the required property `object` from the response with the `200` status
  - added `#/components/schemas/CardExpiringPointsListResponse` to the response body `allOf` list for the response status `200`
- **2026-10-09** (v2) `e2d0b0a800ba`: 1 info
  - added the new optional `query` request parameter `filters`
- **2026-10-07** (v2) `338a5e34004e`: 2 info
  - the endpoint scheme security `X-App-Id AND X-App-Token` was added to the API
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-09-01** (v2) `a972e3958604`: 1 info
  - the response property `cursor/oneOf[#/components/schemas/ListCursor]/expires_at` became required for the status `200`
- **2026-08-28** (v2) `c148961ff7f7`: 1 info
  - added the non-success response with the status `400`
- **2026-08-28** (v2) `4428c9d7f7ee`: 3 warning, 2 info
  - deleted the `path` request parameter `cardId`
  - deleted the `path` request parameter `memberId`
  - deleted the `path` request parameter `programId`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `409`
- **2026-07-31** (v2) `703a0a42ea43`: 1 breaking, 1 info
  - added `#/components/schemas/ListCursor` to the `cursor` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/MemberListCursor` from the `cursor` response property `oneOf` list for the response status `200`
- **2026-07-17** (v2) `4cbaee5a82d5`: 8 info
  - added the optional property `resource_id` to the response with the `400` status
  - added the optional property `resource_id` to the response with the `404` status
  - added the optional property `resource_id` to the response with the `409` status
  - added the optional property `resource_id` to the response with the `500` status
  - added the optional property `resource_type` to the response with the `400` status
  - added the optional property `resource_type` to the response with the `404` status
  - added the optional property `resource_type` to the response with the `409` status
  - added the optional property `resource_type` to the response with the `500` status
- **2026-07-06** (v2) `341403eb19e5`: 15 breaking, 11 warning, 28 info
  - added the pattern `^lcrd_[a-f0-9]+$` to the `path` request parameter `cardId`
  - added the pattern `^lcrspeb_[a-f0-9]+$` to the `query` request parameter `cursor`
  - added the pattern `^lmbr_[a-f0-9]+$` to the `path` request parameter `memberId`
  - added the pattern `^lprg_[a-f0-9]+$` to the `path` request parameter `programId`
  - the response property `code` became optional for the status `400`
  - the response property `code` became optional for the status `404`
  - the response property `code` became optional for the status `500`
  - the response property `key` became optional for the status `400`
  - the response property `key` became optional for the status `404`
  - the response property `key` became optional for the status `500`
  - the response property `message` became optional for the status `400`
  - the response property `message` became optional for the status `404`
  - the response property `message` became optional for the status `500`
  - added `#/components/schemas/MemberListCursor` to the `cursor` response property `oneOf` list for the response status `200`
  - the `data/items/points/total` response's property type changed from `integer` to `number` for status `200`
  - removed the optional property `resource_id` from the response with the `400` status
  - removed the optional property `resource_id` from the response with the `404` status
  - removed the optional property `resource_id` from the response with the `500` status
  - removed the optional property `resource_type` from the response with the `400` status
  - removed the optional property `resource_type` from the response with the `404` status
  - removed the optional property `resource_type` from the response with the `500` status
  - added the new `CALENDAR_EXPIRATION` enum value to the `data/items/expiration_type` response property for the response status `200`
  - added the new `INDIVIDUAL` enum value to the `data/items/card_type` response property for the response status `200`
  - added the new `NO_EXPIRATION` enum value to the `data/items/expiration_type` response property for the response status `200`
  - added the new `ROLLING_EXPIRATION` enum value to the `data/items/expiration_type` response property for the response status `200`
  - added the new `SLIDING_EXPIRATION` enum value to the `data/items/expiration_type` response property for the response status `200`
  - api operation id `listExpiringPoints` removed and replaced with `listCardExpiringPoints`
  - `query` request parameter `order` list-of-types was widened by adding types `null`
  - added the non-success response with the status `409`
  - the response property `cursor` became required for the status `200`
  - the response property `data` became required for the status `200`
  - the response property `data/items/card_definition_id` became required for the status `200`
  - the response property `data/items/card_id` became required for the status `200`
  - the response property `data/items/card_type` became required for the status `200`
  - the response property `data/items/created_at` became required for the status `200`
  - the response property `data/items/customer_id` became required for the status `200`
  - the response property `data/items/expiration_date` became required for the status `200`
  - the response property `data/items/expiration_type` became required for the status `200`
  - the response property `data/items/id` became required for the status `200`
  - the response property `data/items/member_id` became required for the status `200`
  - …14 more

---

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