---
title: "Changes to List rewards v2"
method: GET
path: "/v2/loyalties/rewards"
---

# Changes to List rewards v2

`GET /v2/loyalties/rewards`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 25 of 211 revisions.

- **2026-10-14** (v2) `ec801ade260d`: 4 breaking, 2 info
- **2026-10-13** (v2) `f95b50556c93`: 1 breaking, 5 info
- **2026-10-13** (v2) `9905dfce1d1e`: 4 breaking, 2 info
- **2026-10-13** (v2) `c59a345c733b`: 1 breaking, 5 info
- **2026-10-13** (v2) `4d4d694f1847`: 4 breaking, 2 info
- **2026-10-13** (v2) `84ad572f8dcb`: 1 breaking, 5 info
- **2026-10-13** (v2) `58624588b18c`: 4 breaking, 2 info
- **2026-10-13** (v2) `100ea5942966`: 1 breaking, 5 info
- **2026-10-13** (v2) `ed683aacf90a`: 4 breaking, 2 info
- **2026-10-12** (v2) `d050da3a1603`: 1 breaking, 9 info
- **2026-10-12** (v2) `c56e6909b766`: 9 breaking, 1 warning
- **2026-10-12** (v2) `0f9c09c099aa`: 1 breaking, 3 info
- **2026-10-12** (v2) `1843745ad636`: 3 breaking, 1 warning
- **2026-10-12** (v2) `635f580ab6a9`: 1 breaking, 3 info
- **2026-10-12** (v2) `1ff051999cd4`: 6 info
- **2026-10-09** (v2) `2e03ae2170c5`: 6 breaking
- **2026-10-09** (v2) `80283884ce89`: 6 info
- **2026-10-09** (v2) `8fcaa611eeaf`: 6 breaking
- **2026-10-09** (v2) `1293925d79e2`: 6 info
- **2026-10-09** (v2) `c7ebd351d2e3`: 6 breaking
- **2026-10-09** (v2) `3a8e4a3cadcb`: 6 info
- **2026-10-07** (v2) `338a5e34004e`: 2 info
- **2026-08-03** (v2) `2d8932ee9d4e`: 3 info
- **2026-07-17** (v2) `4cbaee5a82d5`: 8 info
- **2026-07-06** (v2) `341403eb19e5`: 9 breaking, 5 warning, 16 info

## Changes

- **2026-10-14** (v2) `ec801ade260d`: 4 breaking, 2 info
  - for the `query` request parameter `limit`, the type changed from `integer, null` 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
  - added `#/components/schemas/RewardListResponse` to the response body `allOf` list for the response status `200`
  - removed the non-success response with the status `409`
- **2026-10-13** (v2) `f95b50556c93`: 1 breaking, 5 info
  - for the `query` request parameter `limit`, the type changed from `number, string, null` to `integer, null`
  - removed `#/components/schemas/RewardListResponse` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `409`
  - 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, 2 info
  - for the `query` request parameter `limit`, the type changed from `integer, null` 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
  - added `#/components/schemas/RewardListResponse` to the response body `allOf` list for the response status `200`
  - removed the non-success response with the status `409`
- **2026-10-13** (v2) `c59a345c733b`: 1 breaking, 5 info
  - for the `query` request parameter `limit`, the type changed from `number, string, null` to `integer, null`
  - removed `#/components/schemas/RewardListResponse` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `409`
  - 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, 2 info
  - for the `query` request parameter `limit`, the type changed from `integer, null` 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
  - added `#/components/schemas/RewardListResponse` to the response body `allOf` list for the response status `200`
  - removed the non-success response with the status `409`
- **2026-10-13** (v2) `84ad572f8dcb`: 1 breaking, 5 info
  - for the `query` request parameter `limit`, the type changed from `number, string, null` to `integer, null`
  - removed `#/components/schemas/RewardListResponse` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `409`
  - 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, 2 info
  - for the `query` request parameter `limit`, the type changed from `integer, null` 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
  - added `#/components/schemas/RewardListResponse` to the response body `allOf` list for the response status `200`
  - removed the non-success response with the status `409`
- **2026-10-13** (v2) `100ea5942966`: 1 breaking, 5 info
  - for the `query` request parameter `limit`, the type changed from `number, string, null` to `integer, null`
  - removed `#/components/schemas/RewardListResponse` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `409`
  - 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, 2 info
  - for the `query` request parameter `limit`, the type changed from `integer, null` 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
  - added `#/components/schemas/RewardListResponse` to the response body `allOf` list for the response status `200`
  - removed the non-success response with the status `409`
- **2026-10-12** (v2) `d050da3a1603`: 1 breaking, 9 info
  - the `data/items/purchase_limits/cooldown/fixed_cooldown` response's property type changed from no type to `object` for status `200`
  - added the optional property `data/items/costs/items/name` to the response with the `200` status
  - the response property `data/items/end_date` became required for the status `200`
  - the response property `data/items/purchase_limits/cooldown` became required for the status `200`
  - the response property `data/items/purchase_limits/frequency` became required for the status `200`
  - the response property `data/items/start_date` became required for the status `200`
  - the response property `data/items/updated_at` became required for the status `200`
  - removed `#/components/schemas/RewardPurchaseLimitsCooldownFixedCooldown, subschema #2` from the `data/items/purchase_limits/cooldown/fixed_cooldown` response property `oneOf` list for the response status `200`
  - added the required property `data/items/costs/items/tier_rules` to the response with the `200` status
  - added the required property `data/items/purchase_limits/cooldown/fixed_cooldown/period` to the response with the `200` status
- **2026-10-12** (v2) `c56e6909b766`: 9 breaking, 1 warning
  - the response property `data/items/end_date` became optional for the status `200`
  - the response property `data/items/purchase_limits/cooldown` became optional for the status `200`
  - the response property `data/items/purchase_limits/frequency` became optional for the status `200`
  - the response property `data/items/start_date` became optional for the status `200`
  - the response property `data/items/updated_at` became optional for the status `200`
  - added `#/components/schemas/RewardPurchaseLimitsCooldownFixedCooldown, subschema #2` to the `data/items/purchase_limits/cooldown/fixed_cooldown` response property `oneOf` list for the response status `200`
  - the `data/items/purchase_limits/cooldown/fixed_cooldown` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/items/costs/items/tier_rules` from the response with the `200` status
  - removed the required property `data/items/purchase_limits/cooldown/fixed_cooldown/period` from the response with the `200` status
  - removed the optional property `data/items/costs/items/name` from the response with the `200` status
- **2026-10-12** (v2) `0f9c09c099aa`: 1 breaking, 3 info
  - the `data/items/purchase_limits/cooldown/fixed_cooldown` response's property type changed from no type to `object` for status `200`
  - added the optional property `data/items/costs/items/name` to the response with the `200` status
  - removed `#/components/schemas/RewardPurchaseLimitsCooldownFixedCooldown, subschema #2` from the `data/items/purchase_limits/cooldown/fixed_cooldown` response property `oneOf` list for the response status `200`
  - added the required property `data/items/purchase_limits/cooldown/fixed_cooldown/period` to the response with the `200` status
- **2026-10-12** (v2) `1843745ad636`: 3 breaking, 1 warning
  - added `#/components/schemas/RewardPurchaseLimitsCooldownFixedCooldown, subschema #2` to the `data/items/purchase_limits/cooldown/fixed_cooldown` response property `oneOf` list for the response status `200`
  - the `data/items/purchase_limits/cooldown/fixed_cooldown` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/items/purchase_limits/cooldown/fixed_cooldown/period` from the response with the `200` status
  - removed the optional property `data/items/costs/items/name` from the response with the `200` status
- **2026-10-12** (v2) `635f580ab6a9`: 1 breaking, 3 info
  - the `data/items/purchase_limits/cooldown/fixed_cooldown` response's property type changed from no type to `object` for status `200`
  - added the optional property `data/items/costs/items/name` to the response with the `200` status
  - removed `#/components/schemas/RewardPurchaseLimitsCooldownFixedCooldown, subschema #2` from the `data/items/purchase_limits/cooldown/fixed_cooldown` response property `oneOf` list for the response status `200`
  - added the required property `data/items/purchase_limits/cooldown/fixed_cooldown/period` to the response with the `200` status
- **2026-10-12** (v2) `1ff051999cd4`: 6 info
  - the response property `data/items/end_date` became required for the status `200`
  - the response property `data/items/purchase_limits/cooldown` became required for the status `200`
  - the response property `data/items/purchase_limits/frequency` became required for the status `200`
  - the response property `data/items/start_date` became required for the status `200`
  - the response property `data/items/updated_at` became required for the status `200`
  - added the required property `data/items/costs/items/tier_rules` to the response with the `200` status
- **2026-10-09** (v2) `2e03ae2170c5`: 6 breaking
  - the response property `data/items/end_date` became optional for the status `200`
  - the response property `data/items/purchase_limits/cooldown` became optional for the status `200`
  - the response property `data/items/purchase_limits/frequency` became optional for the status `200`
  - the response property `data/items/start_date` became optional for the status `200`
  - the response property `data/items/updated_at` became optional for the status `200`
  - removed the required property `data/items/costs/items/tier_rules` from the response with the `200` status
- **2026-10-09** (v2) `80283884ce89`: 6 info
  - the response property `data/items/end_date` became required for the status `200`
  - the response property `data/items/purchase_limits/cooldown` became required for the status `200`
  - the response property `data/items/purchase_limits/frequency` became required for the status `200`
  - the response property `data/items/start_date` became required for the status `200`
  - the response property `data/items/updated_at` became required for the status `200`
  - added the required property `data/items/costs/items/tier_rules` to the response with the `200` status
- **2026-10-09** (v2) `8fcaa611eeaf`: 6 breaking
  - the response property `data/items/end_date` became optional for the status `200`
  - the response property `data/items/purchase_limits/cooldown` became optional for the status `200`
  - the response property `data/items/purchase_limits/frequency` became optional for the status `200`
  - the response property `data/items/start_date` became optional for the status `200`
  - the response property `data/items/updated_at` became optional for the status `200`
  - removed the required property `data/items/costs/items/tier_rules` from the response with the `200` status
- **2026-10-09** (v2) `1293925d79e2`: 6 info
  - the response property `data/items/end_date` became required for the status `200`
  - the response property `data/items/purchase_limits/cooldown` became required for the status `200`
  - the response property `data/items/purchase_limits/frequency` became required for the status `200`
  - the response property `data/items/start_date` became required for the status `200`
  - the response property `data/items/updated_at` became required for the status `200`
  - added the required property `data/items/costs/items/tier_rules` to the response with the `200` status
- **2026-10-09** (v2) `c7ebd351d2e3`: 6 breaking
  - the response property `data/items/end_date` became optional for the status `200`
  - the response property `data/items/purchase_limits/cooldown` became optional for the status `200`
  - the response property `data/items/purchase_limits/frequency` became optional for the status `200`
  - the response property `data/items/start_date` became optional for the status `200`
  - the response property `data/items/updated_at` became optional for the status `200`
  - removed the required property `data/items/costs/items/tier_rules` from the response with the `200` status
- **2026-10-09** (v2) `3a8e4a3cadcb`: 6 info
  - the response property `data/items/end_date` became required for the status `200`
  - the response property `data/items/purchase_limits/cooldown` became required for the status `200`
  - the response property `data/items/purchase_limits/frequency` became required for the status `200`
  - the response property `data/items/start_date` became required for the status `200`
  - the response property `data/items/updated_at` became required for the status `200`
  - added the required property `data/items/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-08-03** (v2) `2d8932ee9d4e`: 3 info
  - added the optional property `data/items/costs/items/spending/items/name` to the response with the `200` status
  - added the required property `data/items/costs/items/spending/items/id` to the response with the `200` status
  - added the required property `data/items/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
- **2026-07-06** (v2) `341403eb19e5`: 9 breaking, 5 warning, 16 info
  - added the pattern `^lcrsrew_[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/updated_at` 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/RewardListCursor` to the `cursor` response property `oneOf` list for the response 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 `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 `500` status
  - added the new `LOYALTY_CARD_POINTS` enum value to the `data/items/digital/type` response property for the response status `200`
  - `query` request parameter `order` list-of-types was widened by adding types `null`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
  - added the optional property `data/items/digital/loyalty_card_points` to the response with the `200` status
  - added the optional property `data/items/end_date` to the response with the `200` status
  - added the optional property `data/items/start_date` to the response with the `200` status
  - removed `#/components/schemas/PaginationCursor` from the `cursor` response property `oneOf` list for the response status `200`
  - the `data/items/digital/discount_coupons/campaign_id` response's property pattern `^camp_[a-zA-Z0-9]+` was added for the status `200`
  - the `data/items/digital/gift_vouchers/campaign_id` response's property pattern `^camp_[a-zA-Z0-9]+` was added for the status `200`
  - the `data/items/id` response's property pattern `^lrew_[a-f0-9]+$` was added for the status `200`
  - the `data/items/material/product/id` response's property pattern `^prod_[a-f0-9]+` was added for the status `200`
  - the `data/items/material/sku/id` response's property pattern `^sku_[a-f0-9]+` was added for the status `200`
  - the `data/items/material/sku/product_id` response's property pattern `^prod_[a-f0-9]+` was added for the status `200`
  - added the required property `data/items/costs` to the response with the `200` status
  - added the required property `data/items/refunds` to the response with the `200` status
  - added the required property `data/items/validity_hours` to the response with the `200` status

---

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