---
title: "Changes to Examine rewards"
method: POST
path: "/v2/loyalties/examine/rewards"
---

# Changes to Examine rewards

`POST /v2/loyalties/examine/rewards`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 19 of 211 revisions.

- **2026-10-12** (v2) `d050da3a1603`: 1 breaking, 4 info
- **2026-10-12** (v2) `c56e6909b766`: 5 breaking
- **2026-10-12** (v2) `0f9c09c099aa`: 1 breaking, 2 info
- **2026-10-12** (v2) `1843745ad636`: 3 breaking
- **2026-10-12** (v2) `635f580ab6a9`: 1 breaking, 2 info
- **2026-10-12** (v2) `1ff051999cd4`: 2 info
- **2026-10-09** (v2) `2e03ae2170c5`: 2 breaking
- **2026-10-09** (v2) `80283884ce89`: 2 info
- **2026-10-09** (v2) `8fcaa611eeaf`: 2 breaking
- **2026-10-09** (v2) `1293925d79e2`: 2 info
- **2026-10-09** (v2) `c7ebd351d2e3`: 2 breaking
- **2026-10-09** (v2) `3a8e4a3cadcb`: 2 info
- **2026-10-08** (v2) `7001b573e9e9`: 1 breaking
- **2026-10-07** (v2) `338a5e34004e`: 2 info
- **2026-10-06** (v2) `b50db1d1d5fe`: 2 breaking, 2 info
- **2026-08-03** (v2) `2d8932ee9d4e`: 1 info
- **2026-07-31** (v2) `703a0a42ea43`: 6 breaking, 1 warning, 52 info
- **2026-07-17** (v2) `4cbaee5a82d5`: 8 info
- **2026-07-06** (v2) `341403eb19e5`: 1 info

## Changes

- **2026-10-12** (v2) `d050da3a1603`: 1 breaking, 4 info
  - the `rewards/items/purchase_limits/cooldown/fixed_cooldown` response's property type changed from no type to `object` for status `200`
  - the response property `rewards/items/purchase_limits/cooldown` became required for the status `200`
  - the response property `rewards/items/purchase_limits/frequency` became required for the status `200`
  - removed `#/components/schemas/RewardPurchaseLimitsCooldownFixedCooldown, subschema #2` from the `rewards/items/purchase_limits/cooldown/fixed_cooldown` response property `oneOf` list for the response status `200`
  - added the required property `rewards/items/purchase_limits/cooldown/fixed_cooldown/period` to the response with the `200` status
- **2026-10-12** (v2) `c56e6909b766`: 5 breaking
  - the response property `rewards/items/purchase_limits/cooldown` became optional for the status `200`
  - the response property `rewards/items/purchase_limits/frequency` became optional for the status `200`
  - added `#/components/schemas/RewardPurchaseLimitsCooldownFixedCooldown, subschema #2` to the `rewards/items/purchase_limits/cooldown/fixed_cooldown` response property `oneOf` list for the response status `200`
  - the `rewards/items/purchase_limits/cooldown/fixed_cooldown` response's property type changed from `object` to no type for status `200`
  - removed the required property `rewards/items/purchase_limits/cooldown/fixed_cooldown/period` from the response with the `200` status
- **2026-10-12** (v2) `0f9c09c099aa`: 1 breaking, 2 info
  - the `rewards/items/purchase_limits/cooldown/fixed_cooldown` response's property type changed from no type to `object` for status `200`
  - removed `#/components/schemas/RewardPurchaseLimitsCooldownFixedCooldown, subschema #2` from the `rewards/items/purchase_limits/cooldown/fixed_cooldown` response property `oneOf` list for the response status `200`
  - added the required property `rewards/items/purchase_limits/cooldown/fixed_cooldown/period` to the response with the `200` status
- **2026-10-12** (v2) `1843745ad636`: 3 breaking
  - added `#/components/schemas/RewardPurchaseLimitsCooldownFixedCooldown, subschema #2` to the `rewards/items/purchase_limits/cooldown/fixed_cooldown` response property `oneOf` list for the response status `200`
  - the `rewards/items/purchase_limits/cooldown/fixed_cooldown` response's property type changed from `object` to no type for status `200`
  - removed the required property `rewards/items/purchase_limits/cooldown/fixed_cooldown/period` from the response with the `200` status
- **2026-10-12** (v2) `635f580ab6a9`: 1 breaking, 2 info
  - the `rewards/items/purchase_limits/cooldown/fixed_cooldown` response's property type changed from no type to `object` for status `200`
  - removed `#/components/schemas/RewardPurchaseLimitsCooldownFixedCooldown, subschema #2` from the `rewards/items/purchase_limits/cooldown/fixed_cooldown` response property `oneOf` list for the response status `200`
  - added the required property `rewards/items/purchase_limits/cooldown/fixed_cooldown/period` to the response with the `200` status
- **2026-10-12** (v2) `1ff051999cd4`: 2 info
  - the response property `rewards/items/purchase_limits/cooldown` became required for the status `200`
  - the response property `rewards/items/purchase_limits/frequency` became required for the status `200`
- **2026-10-09** (v2) `2e03ae2170c5`: 2 breaking
  - the response property `rewards/items/purchase_limits/cooldown` became optional for the status `200`
  - the response property `rewards/items/purchase_limits/frequency` became optional for the status `200`
- **2026-10-09** (v2) `80283884ce89`: 2 info
  - the response property `rewards/items/purchase_limits/cooldown` became required for the status `200`
  - the response property `rewards/items/purchase_limits/frequency` became required for the status `200`
- **2026-10-09** (v2) `8fcaa611eeaf`: 2 breaking
  - the response property `rewards/items/purchase_limits/cooldown` became optional for the status `200`
  - the response property `rewards/items/purchase_limits/frequency` became optional for the status `200`
- **2026-10-09** (v2) `1293925d79e2`: 2 info
  - the response property `rewards/items/purchase_limits/cooldown` became required for the status `200`
  - the response property `rewards/items/purchase_limits/frequency` became required for the status `200`
- **2026-10-09** (v2) `c7ebd351d2e3`: 2 breaking
  - the response property `rewards/items/purchase_limits/cooldown` became optional for the status `200`
  - the response property `rewards/items/purchase_limits/frequency` became optional for the status `200`
- **2026-10-09** (v2) `3a8e4a3cadcb`: 2 info
  - the response property `rewards/items/purchase_limits/cooldown` became required for the status `200`
  - the response property `rewards/items/purchase_limits/frequency` became required for the status `200`
- **2026-10-08** (v2) `7001b573e9e9`: 1 breaking
  - added `subschema #1` to the request body `allOf` list
- **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`: 2 breaking, 2 info
  - removed `#/components/schemas/Metadata` from the `customer/metadata` request property `oneOf` list
  - removed `#/components/schemas/Metadata` from the `member/metadata` request property `oneOf` list
  - added `#/components/schemas/LoyaltyV2ActivityMetadata` to the `customer/metadata` request property `oneOf` list
  - added `#/components/schemas/LoyaltyV2ActivityMetadata` to the `member/metadata` request property `oneOf` list
- **2026-08-03** (v2) `2d8932ee9d4e`: 1 info
  - added the optional property `rewards/items/purchase_limits` to the response with the `200` status
- **2026-07-31** (v2) `703a0a42ea43`: 6 breaking, 1 warning, 52 info
  - added `subschema #1, subschema #2, subschema #3` to the `customer_identification` request property `allOf` list
  - removed `#/components/schemas/EarningRuleMetadata` from the `customer/metadata` request property `oneOf` list
  - removed `#/components/schemas/EarningRuleMetadata` from the `member/metadata` request property `oneOf` list
  - the response property `customer/source_id` became nullable for the status `200`
  - added `subschema #1: Insufficient balance, subschema #2: No target card` to the `memberships/items/cards/items/rewards/items/unavailability_reasons/items/details` response property `oneOf` list for the response status `200`
  - the `memberships/items/cards/items/rewards/items/unavailability_reasons/items/details` response's property type changed from `string` to no type for status `200`
  - removed `subschema #1, subschema #2, subschema #3` from the `customer_identification` request property `allOf` list
  - added `#/components/schemas/Metadata` to the `customer/metadata` request property `oneOf` list
  - added `#/components/schemas/Metadata` to the `member/metadata` request property `oneOf` list
  - removed the non-success response with the status `409`
  - the response property `customer` became required for the status `200`
  - the response property `customer/id` became required for the status `200`
  - the response property `customer/metadata` became required for the status `200`
  - the response property `customer/object` became required for the status `200`
  - the response property `customer/source_id` became required for the status `200`
  - the response property `memberships` became required for the status `200`
  - the response property `memberships/items/cards` became required for the status `200`
  - the response property `memberships/items/cards/items/card` became required for the status `200`
  - the response property `memberships/items/cards/items/card/card_definition_id` became required for the status `200`
  - the response property `memberships/items/cards/items/card/card_type` became required for the status `200`
  - the response property `memberships/items/cards/items/card/code` became required for the status `200`
  - the response property `memberships/items/cards/items/card/id` became required for the status `200`
  - the response property `memberships/items/cards/items/card/object` became required for the status `200`
  - the response property `memberships/items/cards/items/object` became required for the status `200`
  - the response property `memberships/items/cards/items/rewards` became required for the status `200`
  - the response property `memberships/items/cards/items/rewards/items/cost` became required for the status `200`
  - the response property `memberships/items/cards/items/rewards/items/cost/object` became required for the status `200`
  - the response property `memberships/items/cards/items/rewards/items/cost/points` became required for the status `200`
  - the response property `memberships/items/cards/items/rewards/items/object` became required for the status `200`
  - the response property `memberships/items/cards/items/rewards/items/reward` became required for the status `200`
  - the response property `memberships/items/cards/items/rewards/items/reward/id` became required for the status `200`
  - the response property `memberships/items/cards/items/rewards/items/reward/object` became required for the status `200`
  - the response property `memberships/items/cards/items/rewards/items/status` became required for the status `200`
  - the response property `memberships/items/cards/items/rewards/items/unavailability_reasons/items/details` became required for the status `200`
  - the response property `memberships/items/cards/items/rewards/items/unavailability_reasons/items/object` became required for the status `200`
  - the response property `memberships/items/cards/items/rewards/items/unavailability_reasons/items/reason` became required for the status `200`
  - the response property `memberships/items/member` became required for the status `200`
  - the response property `memberships/items/member/customer_id` became required for the status `200`
  - the response property `memberships/items/member/id` became required for the status `200`
  - the response property `memberships/items/member/metadata` became required for the status `200`
  - …19 more
- **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`: 1 info
  - endpoint added

---

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