--- title: "Changes to Get Card Definition" method: GET path: "/v2/loyalties/card-definitions/{cardDefinitionId}" --- # Changes to Get Card Definition `GET /v2/loyalties/card-definitions/{cardDefinitionId}` > 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`: 16 breaking, 1 warning, 1 info - **2026-10-13** (v2) `f95b50556c93`: 1 breaking, 17 info - **2026-10-13** (v2) `9905dfce1d1e`: 16 breaking, 1 warning, 1 info - **2026-10-13** (v2) `c59a345c733b`: 1 breaking, 17 info - **2026-10-13** (v2) `4d4d694f1847`: 16 breaking, 1 warning, 1 info - **2026-10-13** (v2) `84ad572f8dcb`: 1 breaking, 17 info - **2026-10-13** (v2) `58624588b18c`: 16 breaking, 1 warning, 1 info - **2026-10-13** (v2) `100ea5942966`: 1 breaking, 17 info - **2026-10-13** (v2) `ed683aacf90a`: 16 breaking, 1 warning, 1 info - **2026-10-07** (v2) `338a5e34004e`: 2 info - **2026-10-06** (v2) `b50db1d1d5fe`: 1 breaking, 1 info - **2026-10-01** (v2) `749b6d105462`: 1 breaking, 1 warning - **2026-07-17** (v2) `4cbaee5a82d5`: 8 info ## Changes - **2026-10-14** (v2) `d29b33490051`: 3 breaking, 3 warning, 1 info - the `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration` response's property type changed from `object` to no type for status `200` - removed the required property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/custom_activity_types` from the response with the `200` status - removed the required property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/period` from the response with the `200` status - removed the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/custom_activity` from the response with the `200` status - removed the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/earning_activity` from the response with the `200` status - removed the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/spending_activity` from the response with the `200` status - added `#/components/schemas/CardDefinitionSlidingExpirationActivityBase, subschema #2` to the `allOf[#/components/schemas/CardDefinition]/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/CardDefinition]/points_expiration/sliding_expiration` response's property type changed from no type to `object` for status `200` - added the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/custom_activity` to the response with the `200` status - added the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/earning_activity` to the response with the `200` status - added the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/spending_activity` to the response with the `200` status - removed `#/components/schemas/CardDefinitionSlidingExpirationActivityBase, subschema #2` from the `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration` response property `allOf` list for the response status `200` - added the required property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/custom_activity_types` to the response with the `200` status - added the required property `allOf[#/components/schemas/CardDefinition]/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/CardDefinition]/points_expiration/sliding_expiration` response's property type changed from `object` to no type for status `200` - removed the required property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/custom_activity_types` from the response with the `200` status - removed the required property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/period` from the response with the `200` status - removed the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/custom_activity` from the response with the `200` status - removed the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/earning_activity` from the response with the `200` status - removed the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/spending_activity` from the response with the `200` status - added `#/components/schemas/CardDefinitionSlidingExpirationActivityBase, subschema #2` to the `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration` response property `allOf` list for the response status `200` - **2026-10-14** (v2) `ec801ade260d`: 16 breaking, 1 warning, 1 info - removed the required property `balance_settings` from the response with the `200` status - removed the required property `code_config` from the response with the `200` status - removed the required property `created_at` from the response with the `200` status - removed the required property `earning_limits` from the response with the `200` status - removed the required property `id` from the response with the `200` status - removed the required property `metadata` from the response with the `200` status - removed the required property `name` from the response with the `200` status - removed the required property `object` from the response with the `200` status - removed the required property `pay_with_points` from the response with the `200` status - removed the required property `pending_points` from the response with the `200` status - removed the required property `points_expiration` from the response with the `200` status - removed the required property `refunds` from the response with the `200` status - removed the required property `spending_limits` from the response with the `200` status - removed the required property `status` from the response with the `200` status - removed the required property `type` from the response with the `200` status - removed the required property `updated_at` from the response with the `200` status - deleted the `path` request parameter `cardDefinitionId` - added `#/components/schemas/CardDefinition` to the response body `allOf` list for the response status `200` - **2026-10-13** (v2) `f95b50556c93`: 1 breaking, 17 info - added the new path request parameter `cardDefinitionId` - removed `#/components/schemas/CardDefinition` from the response body `allOf` list for the response status `200` - added the required property `balance_settings` to the response with the `200` status - added the required property `code_config` to the response with the `200` status - added the required property `created_at` to the response with the `200` status - added the required property `earning_limits` to the response with the `200` status - added the required property `id` to the response with the `200` status - added the required property `metadata` to the response with the `200` status - added the required property `name` to the response with the `200` status - added the required property `object` to the response with the `200` status - added the required property `pay_with_points` to the response with the `200` status - added the required property `pending_points` to the response with the `200` status - added the required property `points_expiration` to the response with the `200` status - added the required property `refunds` to the response with the `200` status - added the required property `spending_limits` to the response with the `200` status - added the required property `status` to the response with the `200` status - added the required property `type` to the response with the `200` status - added the required property `updated_at` to the response with the `200` status - **2026-10-13** (v2) `9905dfce1d1e`: 16 breaking, 1 warning, 1 info - removed the required property `balance_settings` from the response with the `200` status - removed the required property `code_config` from the response with the `200` status - removed the required property `created_at` from the response with the `200` status - removed the required property `earning_limits` from the response with the `200` status - removed the required property `id` from the response with the `200` status - removed the required property `metadata` from the response with the `200` status - removed the required property `name` from the response with the `200` status - removed the required property `object` from the response with the `200` status - removed the required property `pay_with_points` from the response with the `200` status - removed the required property `pending_points` from the response with the `200` status - removed the required property `points_expiration` from the response with the `200` status - removed the required property `refunds` from the response with the `200` status - removed the required property `spending_limits` from the response with the `200` status - removed the required property `status` from the response with the `200` status - removed the required property `type` from the response with the `200` status - removed the required property `updated_at` from the response with the `200` status - deleted the `path` request parameter `cardDefinitionId` - added `#/components/schemas/CardDefinition` to the response body `allOf` list for the response status `200` - **2026-10-13** (v2) `c59a345c733b`: 1 breaking, 17 info - added the new path request parameter `cardDefinitionId` - removed `#/components/schemas/CardDefinition` from the response body `allOf` list for the response status `200` - added the required property `balance_settings` to the response with the `200` status - added the required property `code_config` to the response with the `200` status - added the required property `created_at` to the response with the `200` status - added the required property `earning_limits` to the response with the `200` status - added the required property `id` to the response with the `200` status - added the required property `metadata` to the response with the `200` status - added the required property `name` to the response with the `200` status - added the required property `object` to the response with the `200` status - added the required property `pay_with_points` to the response with the `200` status - added the required property `pending_points` to the response with the `200` status - added the required property `points_expiration` to the response with the `200` status - added the required property `refunds` to the response with the `200` status - added the required property `spending_limits` to the response with the `200` status - added the required property `status` to the response with the `200` status - added the required property `type` to the response with the `200` status - added the required property `updated_at` to the response with the `200` status - **2026-10-13** (v2) `4d4d694f1847`: 16 breaking, 1 warning, 1 info - removed the required property `balance_settings` from the response with the `200` status - removed the required property `code_config` from the response with the `200` status - removed the required property `created_at` from the response with the `200` status - removed the required property `earning_limits` from the response with the `200` status - removed the required property `id` from the response with the `200` status - removed the required property `metadata` from the response with the `200` status - removed the required property `name` from the response with the `200` status - removed the required property `object` from the response with the `200` status - removed the required property `pay_with_points` from the response with the `200` status - removed the required property `pending_points` from the response with the `200` status - removed the required property `points_expiration` from the response with the `200` status - removed the required property `refunds` from the response with the `200` status - removed the required property `spending_limits` from the response with the `200` status - removed the required property `status` from the response with the `200` status - removed the required property `type` from the response with the `200` status - removed the required property `updated_at` from the response with the `200` status - deleted the `path` request parameter `cardDefinitionId` - added `#/components/schemas/CardDefinition` to the response body `allOf` list for the response status `200` - **2026-10-13** (v2) `84ad572f8dcb`: 1 breaking, 17 info - added the new path request parameter `cardDefinitionId` - removed `#/components/schemas/CardDefinition` from the response body `allOf` list for the response status `200` - added the required property `balance_settings` to the response with the `200` status - added the required property `code_config` to the response with the `200` status - added the required property `created_at` to the response with the `200` status - added the required property `earning_limits` to the response with the `200` status - added the required property `id` to the response with the `200` status - added the required property `metadata` to the response with the `200` status - added the required property `name` to the response with the `200` status - added the required property `object` to the response with the `200` status - added the required property `pay_with_points` to the response with the `200` status - added the required property `pending_points` to the response with the `200` status - added the required property `points_expiration` to the response with the `200` status - added the required property `refunds` to the response with the `200` status - added the required property `spending_limits` to the response with the `200` status - added the required property `status` to the response with the `200` status - added the required property `type` to the response with the `200` status - added the required property `updated_at` to the response with the `200` status - **2026-10-13** (v2) `58624588b18c`: 16 breaking, 1 warning, 1 info - removed the required property `balance_settings` from the response with the `200` status - removed the required property `code_config` from the response with the `200` status - removed the required property `created_at` from the response with the `200` status - removed the required property `earning_limits` from the response with the `200` status - removed the required property `id` from the response with the `200` status - removed the required property `metadata` from the response with the `200` status - removed the required property `name` from the response with the `200` status - removed the required property `object` from the response with the `200` status - removed the required property `pay_with_points` from the response with the `200` status - removed the required property `pending_points` from the response with the `200` status - removed the required property `points_expiration` from the response with the `200` status - removed the required property `refunds` from the response with the `200` status - removed the required property `spending_limits` from the response with the `200` status - removed the required property `status` from the response with the `200` status - removed the required property `type` from the response with the `200` status - removed the required property `updated_at` from the response with the `200` status - deleted the `path` request parameter `cardDefinitionId` - added `#/components/schemas/CardDefinition` to the response body `allOf` list for the response status `200` - **2026-10-13** (v2) `100ea5942966`: 1 breaking, 17 info - added the new path request parameter `cardDefinitionId` - removed `#/components/schemas/CardDefinition` from the response body `allOf` list for the response status `200` - added the required property `balance_settings` to the response with the `200` status - added the required property `code_config` to the response with the `200` status - added the required property `created_at` to the response with the `200` status - added the required property `earning_limits` to the response with the `200` status - added the required property `id` to the response with the `200` status - added the required property `metadata` to the response with the `200` status - added the required property `name` to the response with the `200` status - added the required property `object` to the response with the `200` status - added the required property `pay_with_points` to the response with the `200` status - added the required property `pending_points` to the response with the `200` status - added the required property `points_expiration` to the response with the `200` status - added the required property `refunds` to the response with the `200` status - added the required property `spending_limits` to the response with the `200` status - added the required property `status` to the response with the `200` status - added the required property `type` to the response with the `200` status - added the required property `updated_at` to the response with the `200` status - **2026-10-13** (v2) `ed683aacf90a`: 16 breaking, 1 warning, 1 info - removed the required property `balance_settings` from the response with the `200` status - removed the required property `code_config` from the response with the `200` status - removed the required property `created_at` from the response with the `200` status - removed the required property `earning_limits` from the response with the `200` status - removed the required property `id` from the response with the `200` status - removed the required property `metadata` from the response with the `200` status - removed the required property `name` from the response with the `200` status - removed the required property `object` from the response with the `200` status - removed the required property `pay_with_points` from the response with the `200` status - removed the required property `pending_points` from the response with the `200` status - removed the required property `points_expiration` from the response with the `200` status - removed the required property `refunds` from the response with the `200` status - removed the required property `spending_limits` from the response with the `200` status - removed the required property `status` from the response with the `200` status - removed the required property `type` from the response with the `200` status - removed the required property `updated_at` from the response with the `200` status - deleted the `path` request parameter `cardDefinitionId` - added `#/components/schemas/CardDefinition` 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 `points_expiration/rolling_expiration/rounding` response property `oneOf` list for the response status `200` - removed `#/components/schemas/CardDefinitionPointsExpirationRollingExpirationRounding` from the `points_expiration/rolling_expiration/rounding` response property `oneOf` list for the response status `200` - **2026-10-01** (v2) `749b6d105462`: 1 breaking, 1 warning - added the new path request parameter `cardDefinitionId` - deleted the `path` request parameter `id` - **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 --- [Operation](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/docs/v2/loyalties/card-definitions/:cardDefinitionId/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/:cardDefinitionId/get)