---
title: "Changes to Get reward by ID"
method: GET
path: "/v2/loyalties/rewards/{rewardId}"
---

# Changes to Get reward by ID

`GET /v2/loyalties/rewards/{rewardId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 18 of 211 revisions.

- **2026-10-12** (v2) `d050da3a1603`: 11 breaking, 6 warning, 3 info
- **2026-10-12** (v2) `c56e6909b766`: 1 breaking, 19 info
- **2026-10-12** (v2) `0f9c09c099aa`: 1 breaking, 1 warning, 3 info
- **2026-10-12** (v2) `1843745ad636`: 4 breaking, 1 warning
- **2026-10-12** (v2) `635f580ab6a9`: 1 breaking, 3 info
- **2026-10-12** (v2) `661b3efb701f`: 1 warning
- **2026-10-12** (v2) `4e124520844d`: 14 breaking, 2 warning, 1 info
- **2026-10-12** (v2) `1ff051999cd4`: 8 info
- **2026-10-09** (v2) `2e03ae2170c5`: 6 breaking, 2 info
- **2026-10-09** (v2) `80283884ce89`: 8 info
- **2026-10-09** (v2) `8fcaa611eeaf`: 6 breaking, 2 info
- **2026-10-09** (v2) `1293925d79e2`: 8 info
- **2026-10-09** (v2) `c7ebd351d2e3`: 6 breaking, 2 info
- **2026-10-09** (v2) `3a8e4a3cadcb`: 8 info
- **2026-10-07** (v2) `338a5e34004e`: 2 info
- **2026-10-01** (v2) `749b6d105462`: 1 breaking, 1 warning
- **2026-08-03** (v2) `2d8932ee9d4e`: 3 info
- **2026-07-17** (v2) `4cbaee5a82d5`: 8 info

## Changes

- **2026-10-12** (v2) `d050da3a1603`: 11 breaking, 6 warning, 3 info
  - removed the required property `costs` from the response with the `200` status
  - removed the required property `created_at` 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 `purchase_limits` from the response with the `200` status
  - removed the required property `refunds` 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 `validity_hours` from the response with the `200` status
  - deleted the `path` request parameter `rewardId`
  - removed the optional property `digital` from the response with the `200` status
  - removed the optional property `end_date` from the response with the `200` status
  - removed the optional property `material` from the response with the `200` status
  - removed the optional property `start_date` from the response with the `200` status
  - removed the optional property `updated_at` from the response with the `200` status
  - added `#/components/schemas/RewardResponse` to the response body `allOf` list for the response status `200`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `409`
- **2026-10-12** (v2) `c56e6909b766`: 1 breaking, 19 info
  - added the new path request parameter `rewardId`
  - removed `#/components/schemas/RewardResponse` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `400`
  - added the non-success response with the status `409`
  - added the optional property `digital` to the response with the `200` status
  - added the optional property `end_date` to the response with the `200` status
  - added the optional property `material` to the response with the `200` status
  - added the optional property `start_date` to the response with the `200` status
  - added the optional property `updated_at` to the response with the `200` status
  - added the required property `costs` to the response with the `200` status
  - added the required property `created_at` 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 `purchase_limits` to the response with the `200` status
  - added the required property `refunds` 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 `validity_hours` to the response with the `200` status
- **2026-10-12** (v2) `0f9c09c099aa`: 1 breaking, 1 warning, 3 info
  - the `allOf[#/components/schemas/RewardResponse]/purchase_limits/cooldown/fixed_cooldown` response's property type changed from no type to `object` for status `200`
  - deleted the `path` request parameter `rewardId`
  - added the optional property `allOf[#/components/schemas/RewardResponse]/costs/items/name` to the response with the `200` status
  - removed `#/components/schemas/RewardPurchaseLimitsCooldownFixedCooldown, subschema #2` from the `allOf[#/components/schemas/RewardResponse]/purchase_limits/cooldown/fixed_cooldown` response property `oneOf` list for the response status `200`
  - added the required property `allOf[#/components/schemas/RewardResponse]/purchase_limits/cooldown/fixed_cooldown/period` to the response with the `200` status
- **2026-10-12** (v2) `1843745ad636`: 4 breaking, 1 warning
  - added the new path request parameter `rewardId`
  - added `#/components/schemas/RewardPurchaseLimitsCooldownFixedCooldown, subschema #2` to the `allOf[#/components/schemas/RewardResponse]/purchase_limits/cooldown/fixed_cooldown` response property `oneOf` list for the response status `200`
  - the `allOf[#/components/schemas/RewardResponse]/purchase_limits/cooldown/fixed_cooldown` response's property type changed from `object` to no type for status `200`
  - removed the required property `allOf[#/components/schemas/RewardResponse]/purchase_limits/cooldown/fixed_cooldown/period` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/RewardResponse]/costs/items/name` from the response with the `200` status
- **2026-10-12** (v2) `635f580ab6a9`: 1 breaking, 3 info
  - the `allOf[#/components/schemas/RewardResponse]/purchase_limits/cooldown/fixed_cooldown` response's property type changed from no type to `object` for status `200`
  - added the optional property `allOf[#/components/schemas/RewardResponse]/costs/items/name` to the response with the `200` status
  - removed `#/components/schemas/RewardPurchaseLimitsCooldownFixedCooldown, subschema #2` from the `allOf[#/components/schemas/RewardResponse]/purchase_limits/cooldown/fixed_cooldown` response property `oneOf` list for the response status `200`
  - added the required property `allOf[#/components/schemas/RewardResponse]/purchase_limits/cooldown/fixed_cooldown/period` to the response with the `200` status
- **2026-10-12** (v2) `661b3efb701f`: 1 warning
  - deleted the `path` request parameter `rewardId`
- **2026-10-12** (v2) `4e124520844d`: 14 breaking, 2 warning, 1 info
  - removed the required property `costs` from the response with the `200` status
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `end_date` 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 `purchase_limits` from the response with the `200` status
  - removed the required property `refunds` from the response with the `200` status
  - removed the required property `start_date` 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
  - removed the required property `validity_hours` from the response with the `200` status
  - removed the optional property `digital` from the response with the `200` status
  - removed the optional property `material` from the response with the `200` status
  - added `#/components/schemas/RewardResponse` to the response body `allOf` list for the response status `200`
- **2026-10-12** (v2) `1ff051999cd4`: 8 info
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `409`
  - the response property `end_date` became required for the status `200`
  - the response property `purchase_limits/cooldown` became required for the status `200`
  - the response property `purchase_limits/frequency` became required for the status `200`
  - the response property `start_date` became required for the status `200`
  - the response property `updated_at` became required for the status `200`
  - added the required property `costs/items/tier_rules` to the response with the `200` status
- **2026-10-09** (v2) `2e03ae2170c5`: 6 breaking, 2 info
  - the response property `end_date` became optional for the status `200`
  - the response property `purchase_limits/cooldown` became optional for the status `200`
  - the response property `purchase_limits/frequency` became optional for the status `200`
  - the response property `start_date` became optional for the status `200`
  - the response property `updated_at` became optional for the status `200`
  - removed the required property `costs/items/tier_rules` from the response with the `200` status
  - added the non-success response with the status `400`
  - added the non-success response with the status `409`
- **2026-10-09** (v2) `80283884ce89`: 8 info
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `409`
  - the response property `end_date` became required for the status `200`
  - the response property `purchase_limits/cooldown` became required for the status `200`
  - the response property `purchase_limits/frequency` became required for the status `200`
  - the response property `start_date` became required for the status `200`
  - the response property `updated_at` became required for the status `200`
  - added the required property `costs/items/tier_rules` to the response with the `200` status
- **2026-10-09** (v2) `8fcaa611eeaf`: 6 breaking, 2 info
  - the response property `end_date` became optional for the status `200`
  - the response property `purchase_limits/cooldown` became optional for the status `200`
  - the response property `purchase_limits/frequency` became optional for the status `200`
  - the response property `start_date` became optional for the status `200`
  - the response property `updated_at` became optional for the status `200`
  - removed the required property `costs/items/tier_rules` from the response with the `200` status
  - added the non-success response with the status `400`
  - added the non-success response with the status `409`
- **2026-10-09** (v2) `1293925d79e2`: 8 info
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `409`
  - the response property `end_date` became required for the status `200`
  - the response property `purchase_limits/cooldown` became required for the status `200`
  - the response property `purchase_limits/frequency` became required for the status `200`
  - the response property `start_date` became required for the status `200`
  - the response property `updated_at` became required for the status `200`
  - added the required property `costs/items/tier_rules` to the response with the `200` status
- **2026-10-09** (v2) `c7ebd351d2e3`: 6 breaking, 2 info
  - the response property `end_date` became optional for the status `200`
  - the response property `purchase_limits/cooldown` became optional for the status `200`
  - the response property `purchase_limits/frequency` became optional for the status `200`
  - the response property `start_date` became optional for the status `200`
  - the response property `updated_at` became optional for the status `200`
  - removed the required property `costs/items/tier_rules` from the response with the `200` status
  - added the non-success response with the status `400`
  - added the non-success response with the status `409`
- **2026-10-09** (v2) `3a8e4a3cadcb`: 8 info
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `409`
  - the response property `end_date` became required for the status `200`
  - the response property `purchase_limits/cooldown` became required for the status `200`
  - the response property `purchase_limits/frequency` became required for the status `200`
  - the response property `start_date` became required for the status `200`
  - the response property `updated_at` became required for the status `200`
  - added the required property `costs/items/tier_rules` to the response with the `200` status
- **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-01** (v2) `749b6d105462`: 1 breaking, 1 warning
  - added the new path request parameter `rewardId`
  - deleted the `path` request parameter `id`
- **2026-08-03** (v2) `2d8932ee9d4e`: 3 info
  - added the optional property `costs/items/spending/items/name` to the response with the `200` status
  - added the required property `costs/items/spending/items/id` to the response with the `200` status
  - added the required property `purchase_limits` to the response with the `200` status
- **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/rewards/:rewardId/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/rewards/:rewardId/get)
