---
title: "Changes to List Card Definitions"
method: GET
path: "/v2/loyalties/card-definitions"
---

# Changes to List Card Definitions

`GET /v2/loyalties/card-definitions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 16 of 211 revisions.

- **2026-10-14** (v2) `d29b33490051`: 3 breaking, 3 warning, 1 info
- **2026-10-14** (v2) `be14b3318eb3`: 1 breaking, 6 info
- **2026-10-14** (v2) `6a418ac8b7b1`: 3 breaking, 3 warning, 1 info
- **2026-10-14** (v2) `ec801ade260d`: 4 breaking, 3 info
- **2026-10-13** (v2) `f95b50556c93`: 3 breaking, 4 info
- **2026-10-13** (v2) `9905dfce1d1e`: 4 breaking, 3 info
- **2026-10-13** (v2) `c59a345c733b`: 3 breaking, 4 info
- **2026-10-13** (v2) `4d4d694f1847`: 4 breaking, 3 info
- **2026-10-13** (v2) `84ad572f8dcb`: 3 breaking, 4 info
- **2026-10-13** (v2) `58624588b18c`: 4 breaking, 3 info
- **2026-10-13** (v2) `100ea5942966`: 3 breaking, 4 info
- **2026-10-13** (v2) `ed683aacf90a`: 4 breaking, 3 info
- **2026-10-07** (v2) `338a5e34004e`: 2 info
- **2026-10-06** (v2) `b50db1d1d5fe`: 1 breaking, 1 info
- **2026-07-17** (v2) `4cbaee5a82d5`: 8 info
- **2026-07-06** (v2) `341403eb19e5`: 30 breaking, 31 warning, 36 info

## Changes

- **2026-10-14** (v2) `d29b33490051`: 3 breaking, 3 warning, 1 info
  - the `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration` response's property type changed from `object` to no type for status `200`
  - removed the required property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/custom_activity_types` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/period` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/custom_activity` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/earning_activity` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/spending_activity` from the response with the `200` status
  - added `#/components/schemas/CardDefinitionSlidingExpirationActivityBase, subschema #2` to the `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration` response property `allOf` list for the response status `200`
- **2026-10-14** (v2) `be14b3318eb3`: 1 breaking, 6 info
  - the `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration` response's property type changed from no type to `object` for status `200`
  - added the optional property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/custom_activity` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/earning_activity` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/spending_activity` to the response with the `200` status
  - removed `#/components/schemas/CardDefinitionSlidingExpirationActivityBase, subschema #2` from the `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration` response property `allOf` list for the response status `200`
  - added the required property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/custom_activity_types` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/period` to the response with the `200` status
- **2026-10-14** (v2) `6a418ac8b7b1`: 3 breaking, 3 warning, 1 info
  - the `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration` response's property type changed from `object` to no type for status `200`
  - removed the required property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/custom_activity_types` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/period` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/custom_activity` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/earning_activity` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration/spending_activity` from the response with the `200` status
  - added `#/components/schemas/CardDefinitionSlidingExpirationActivityBase, subschema #2` to the `allOf[#/components/schemas/CardDefinitionListResponse]/data/items/points_expiration/sliding_expiration` response property `allOf` list for the response status `200`
- **2026-10-14** (v2) `ec801ade260d`: 4 breaking, 3 info
  - for the `query` request parameter `limit`, the type changed from `integer` to `number, string, null`
  - 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
  - `query` request parameter `order` list-of-types was widened by adding types `null`
  - for the `query` request parameter `filters`, the type was generalized from `object` to no type
  - added `#/components/schemas/CardDefinitionListResponse` to the response body `allOf` list for the response status `200`
- **2026-10-13** (v2) `f95b50556c93`: 3 breaking, 4 info
  - `query` request parameter `order` list-of-types was narrowed by removing types `null`
  - for the `query` request parameter `filters`, the type changed from no type to `object`
  - for the `query` request parameter `limit`, the type changed from `number, string, null` to `integer`
  - removed `#/components/schemas/CardDefinitionListResponse` 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`: 4 breaking, 3 info
  - for the `query` request parameter `limit`, the type changed from `integer` to `number, string, null`
  - 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
  - `query` request parameter `order` list-of-types was widened by adding types `null`
  - for the `query` request parameter `filters`, the type was generalized from `object` to no type
  - added `#/components/schemas/CardDefinitionListResponse` to the response body `allOf` list for the response status `200`
- **2026-10-13** (v2) `c59a345c733b`: 3 breaking, 4 info
  - `query` request parameter `order` list-of-types was narrowed by removing types `null`
  - for the `query` request parameter `filters`, the type changed from no type to `object`
  - for the `query` request parameter `limit`, the type changed from `number, string, null` to `integer`
  - removed `#/components/schemas/CardDefinitionListResponse` 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) `4d4d694f1847`: 4 breaking, 3 info
  - for the `query` request parameter `limit`, the type changed from `integer` to `number, string, null`
  - 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
  - `query` request parameter `order` list-of-types was widened by adding types `null`
  - for the `query` request parameter `filters`, the type was generalized from `object` to no type
  - added `#/components/schemas/CardDefinitionListResponse` to the response body `allOf` list for the response status `200`
- **2026-10-13** (v2) `84ad572f8dcb`: 3 breaking, 4 info
  - `query` request parameter `order` list-of-types was narrowed by removing types `null`
  - for the `query` request parameter `filters`, the type changed from no type to `object`
  - for the `query` request parameter `limit`, the type changed from `number, string, null` to `integer`
  - removed `#/components/schemas/CardDefinitionListResponse` 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) `58624588b18c`: 4 breaking, 3 info
  - for the `query` request parameter `limit`, the type changed from `integer` to `number, string, null`
  - 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
  - `query` request parameter `order` list-of-types was widened by adding types `null`
  - for the `query` request parameter `filters`, the type was generalized from `object` to no type
  - added `#/components/schemas/CardDefinitionListResponse` to the response body `allOf` list for the response status `200`
- **2026-10-13** (v2) `100ea5942966`: 3 breaking, 4 info
  - `query` request parameter `order` list-of-types was narrowed by removing types `null`
  - for the `query` request parameter `filters`, the type changed from no type to `object`
  - for the `query` request parameter `limit`, the type changed from `number, string, null` to `integer`
  - removed `#/components/schemas/CardDefinitionListResponse` 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) `ed683aacf90a`: 4 breaking, 3 info
  - for the `query` request parameter `limit`, the type changed from `integer` to `number, string, null`
  - 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
  - `query` request parameter `order` list-of-types was widened by adding types `null`
  - for the `query` request parameter `filters`, the type was generalized from `object` to no type
  - added `#/components/schemas/CardDefinitionListResponse` to the response body `allOf` list for the response status `200`
- **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-10-06** (v2) `b50db1d1d5fe`: 1 breaking, 1 info
  - added `#/components/schemas/LoyaltyV2ActivityCardDefinitionPointsExpirationRollingExpirationRounding` to the `data/items/points_expiration/rolling_expiration/rounding` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/CardDefinitionPointsExpirationRollingExpirationRounding` from the `data/items/points_expiration/rolling_expiration/rounding` 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`: 30 breaking, 31 warning, 36 info
  - added the pattern `^lcrscdef_[a-f0-9]+$` to the `query` request parameter `cursor`
  - the response property `code` became optional for the status `400`
  - the response property `code` became optional for the status `500`
  - the response property `data/items/earning_limits/global` became optional for the status `200`
  - the response property `data/items/earning_limits/transactions` became optional for the status `200`
  - the response property `data/items/spending_limits/global` became optional for the status `200`
  - the response property `data/items/spending_limits/transactions` became optional for the status `200`
  - the response property `key` became optional for the status `400`
  - 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 `500`
  - added `#/components/schemas/CardDefinitionListCursor` to the `cursor` response property `oneOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `data/items/earning_limits/global/limits/items/` response property `oneOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `data/items/earning_limits/transactions/limits/items/` response property `oneOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `data/items/refunds/earned_points/methods/items/` response property `oneOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `data/items/spending_limits/global/limits/items/` response property `oneOf` list for the response status `200`
  - the `data/items/earning_limits/global/limits/items/` response's property type changed from `object` to no type for status `200`
  - the `data/items/earning_limits/transactions/limits/items/` response's property type changed from `object` to no type for status `200`
  - the `data/items/pending_points/event_based` response's property type changed from no type to `object` for status `200`
  - the `data/items/pending_points/fixed_dates` response's property type changed from no type to `object` for status `200`
  - the `data/items/pending_points/period_based` response's property type changed from no type to `object` for status `200`
  - the `data/items/points_expiration/calendar_expiration` response's property type changed from no type to `object` for status `200`
  - the `data/items/points_expiration/rolling_expiration` response's property type changed from no type to `object` for status `200`
  - the `data/items/points_expiration/sliding_expiration` response's property type changed from no type to `object` for status `200`
  - the `data/items/refunds/earned_points/methods/items/` response's property type changed from `object` to no type for status `200`
  - the `data/items/spending_limits/global/limits/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/items/earning_limits/global/limits/items/type` from the response with the `200` status
  - removed the required property `data/items/earning_limits/transactions/limits/items/type` from the response with the `200` status
  - removed the required property `data/items/refunds/earned_points/methods/items/type` from the response with the `200` status
  - removed the required property `data/items/spending_limits/global/limits/items/type` from the response with the `200` status
  - deleted the `query` request parameter `filters[created_at][conditions][$after]`
  - deleted the `query` request parameter `filters[created_at][conditions][$before]`
  - deleted the `query` request parameter `filters[id][conditions][$in]`
  - deleted the `query` request parameter `filters[id][conditions][$is]`
  - deleted the `query` request parameter `filters[id][conditions][$is_not]`
  - deleted the `query` request parameter `filters[id][conditions][$not_in]`
  - deleted the `query` request parameter `filters[junction]`
  - deleted the `query` request parameter `filters[name][conditions][$contains]`
  - deleted the `query` request parameter `filters[name][conditions][$ends_with]`
  - deleted the `query` request parameter `filters[name][conditions][$is]`
  - …57 more

---

[Operation](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/docs/v2/loyalties/card-definitions/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/card-definitions/get)
