--- title: "Changes to List benefits" method: GET path: "/v2/loyalties/benefits" --- # Changes to List benefits `GET /v2/loyalties/benefits` > Every recorded change to this operation, newest first. ## Timeline Changed in 22 of 211 revisions. - **2026-10-14** (v2) `ec801ade260d`: 4 breaking, 3 info - **2026-10-13** (v2) `f95b50556c93`: 2 breaking, 5 info - **2026-10-13** (v2) `9905dfce1d1e`: 4 breaking, 3 info - **2026-10-13** (v2) `c59a345c733b`: 2 breaking, 5 info - **2026-10-13** (v2) `4d4d694f1847`: 4 breaking, 3 info - **2026-10-13** (v2) `84ad572f8dcb`: 2 breaking, 5 info - **2026-10-13** (v2) `58624588b18c`: 4 breaking, 3 info - **2026-10-13** (v2) `100ea5942966`: 2 breaking, 5 info - **2026-10-13** (v2) `ed683aacf90a`: 4 breaking, 3 info - **2026-10-12** (v2) `d050da3a1603`: 2 info - **2026-10-12** (v2) `c56e6909b766`: 2 breaking - **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) `10907cb5e897`: 2 info - **2026-10-07** (v2) `338a5e34004e`: 2 info - **2026-10-06** (v2) `b50db1d1d5fe`: 20 breaking, 32 info - **2026-07-17** (v2) `4cbaee5a82d5`: 8 info - **2026-07-06** (v2) `341403eb19e5`: 1 info ## Changes - **2026-10-14** (v2) `ec801ade260d`: 4 breaking, 3 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 - for the `query` request parameter `filters`, the type was generalized from `object` to no type - added `#/components/schemas/BenefitListResponse` 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`: 2 breaking, 5 info - 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, null` - removed `#/components/schemas/BenefitListResponse` 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, 3 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 - for the `query` request parameter `filters`, the type was generalized from `object` to no type - added `#/components/schemas/BenefitListResponse` 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`: 2 breaking, 5 info - 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, null` - removed `#/components/schemas/BenefitListResponse` 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, 3 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 - for the `query` request parameter `filters`, the type was generalized from `object` to no type - added `#/components/schemas/BenefitListResponse` 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`: 2 breaking, 5 info - 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, null` - removed `#/components/schemas/BenefitListResponse` 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, 3 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 - for the `query` request parameter `filters`, the type was generalized from `object` to no type - added `#/components/schemas/BenefitListResponse` 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`: 2 breaking, 5 info - 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, null` - removed `#/components/schemas/BenefitListResponse` 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, 3 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 - for the `query` request parameter `filters`, the type was generalized from `object` to no type - added `#/components/schemas/BenefitListResponse` 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`: 2 info - the response property `data/items/stock` became required for the status `200` - the response property `data/items/updated_at` became required for the status `200` - **2026-10-12** (v2) `c56e6909b766`: 2 breaking - the response property `data/items/stock` became optional for the status `200` - the response property `data/items/updated_at` became optional for the status `200` - **2026-10-12** (v2) `1ff051999cd4`: 2 info - the response property `data/items/stock` became required for the status `200` - the response property `data/items/updated_at` became required for the status `200` - **2026-10-09** (v2) `2e03ae2170c5`: 2 breaking - the response property `data/items/stock` became optional for the status `200` - the response property `data/items/updated_at` became optional for the status `200` - **2026-10-09** (v2) `80283884ce89`: 2 info - the response property `data/items/stock` became required for the status `200` - the response property `data/items/updated_at` became required for the status `200` - **2026-10-09** (v2) `8fcaa611eeaf`: 2 breaking - the response property `data/items/stock` became optional for the status `200` - the response property `data/items/updated_at` became optional for the status `200` - **2026-10-09** (v2) `1293925d79e2`: 2 info - the response property `data/items/stock` became required for the status `200` - the response property `data/items/updated_at` became required for the status `200` - **2026-10-09** (v2) `c7ebd351d2e3`: 2 breaking - the response property `data/items/stock` became optional for the status `200` - the response property `data/items/updated_at` became optional for the status `200` - **2026-10-09** (v2) `10907cb5e897`: 2 info - the response property `data/items/stock` became required for the status `200` - the response property `data/items/updated_at` became required for the 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`: 20 breaking, 32 info - added `#/components/schemas/LoyaltyV2ActivityBenefitDigitalDiscountCoupons` to the `data/items/digital/oneOf[#/components/schemas/BenefitDigital]/discount_coupons` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitDigitalGiftVouchers` to the `data/items/digital/oneOf[#/components/schemas/BenefitDigital]/gift_vouchers` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitMaterialProduct` to the `data/items/material/oneOf[#/components/schemas/BenefitMaterial]/product` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitMaterialSKU` to the `data/items/material/oneOf[#/components/schemas/BenefitMaterial]/sku` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPoints` to the `data/items/points` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPointsProportionalApplicableToProduct` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/amount/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/product` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPointsProportionalApplicableToProduct` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/quantity/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/product` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPointsProportionalApplicableToProduct` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/subtotal_amount/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/product` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPointsProportionalApplicableToProductsCollection` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/amount/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/products_collection` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPointsProportionalApplicableToProductsCollection` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/quantity/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/products_collection` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPointsProportionalApplicableToProductsCollection` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/subtotal_amount/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/products_collection` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPointsProportionalApplicableToSku` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/amount/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/sku` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPointsProportionalApplicableToSku` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/quantity/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/sku` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPointsProportionalApplicableToSku` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/subtotal_amount/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/sku` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPointsProportionalEvery` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order/oneOf[#/components/schemas/BenefitPointsProportionalOrder]/amount` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPointsProportionalEvery` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order/oneOf[#/components/schemas/BenefitPointsProportionalOrder]/total_amount` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPointsProportionalMetadata` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/custom_event/oneOf[#/components/schemas/BenefitPointsProportionalCustomEvent]/metadata` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPointsProportionalMetadata` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/customer/oneOf[#/components/schemas/BenefitPointsProportionalCustomer]/metadata` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitPointsProportionalMetadata` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order/oneOf[#/components/schemas/BenefitPointsProportionalOrder]/metadata` response property `oneOf` list for the response status `200` - added `#/components/schemas/LoyaltyV2ActivityBenefitStockLimited` to the `data/items/stock/oneOf[#/components/schemas/BenefitStock]/limited` response property `oneOf` list for the response status `200` - added `subschema #1, subschema #2, subschema #3` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/amount/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/` response property `allOf` list for the response status `200` - added `subschema #1, subschema #2, subschema #3` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/quantity/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/` response property `allOf` list for the response status `200` - added `subschema #1, subschema #2, subschema #3` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/subtotal_amount/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/` response property `allOf` list for the response status `200` - added `subschema #2, subschema #3` to the `data/items/digital/oneOf[#/components/schemas/BenefitDigital]/` response property `allOf` list for the response status `200` - added `subschema #2, subschema #3` to the `data/items/material/oneOf[#/components/schemas/BenefitMaterial]/` response property `allOf` list for the response status `200` - added `subschema #4, subschema #5` to the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/` response property `allOf` list for the response status `200` - removed `subschema #1, subschema #2, subschema #3` from the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/amount/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/` response property `allOf` list for the response status `200` - removed `subschema #1, subschema #2, subschema #3` from the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/quantity/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/` response property `allOf` list for the response status `200` - removed `subschema #1, subschema #2, subschema #3` from the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/subtotal_amount/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/` response property `allOf` list for the response status `200` - removed `subschema #2, subschema #3` from the `data/items/digital/oneOf[#/components/schemas/BenefitDigital]/` response property `allOf` list for the response status `200` - removed `subschema #2, subschema #3` from the `data/items/material/oneOf[#/components/schemas/BenefitMaterial]/` response property `allOf` list for the response status `200` - removed `subschema #4, subschema #5` from the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/` response property `allOf` list for the response status `200` - removed `#/components/schemas/BenefitDigitalDiscountCoupons` from the `data/items/digital/oneOf[#/components/schemas/BenefitDigital]/discount_coupons` response property `oneOf` list for the response status `200` - removed `#/components/schemas/BenefitDigitalGiftVouchers` from the `data/items/digital/oneOf[#/components/schemas/BenefitDigital]/gift_vouchers` response property `oneOf` list for the response status `200` - removed `#/components/schemas/BenefitMaterialProduct` from the `data/items/material/oneOf[#/components/schemas/BenefitMaterial]/product` response property `oneOf` list for the response status `200` - removed `#/components/schemas/BenefitMaterialSKU` from the `data/items/material/oneOf[#/components/schemas/BenefitMaterial]/sku` response property `oneOf` list for the response status `200` - removed `#/components/schemas/BenefitPoints` from the `data/items/points` response property `oneOf` list for the response status `200` - removed `#/components/schemas/BenefitPointsProportionalApplicableToProduct` from the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/amount/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/product` response property `oneOf` list for the response status `200` - removed `#/components/schemas/BenefitPointsProportionalApplicableToProduct` from the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/quantity/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/product` response property `oneOf` list for the response status `200` - removed `#/components/schemas/BenefitPointsProportionalApplicableToProduct` from the `data/items/points_proportional/oneOf[#/components/schemas/BenefitPointsProportional]/order_items/oneOf[#/components/schemas/BenefitPointsProportionalOrderItems]/subtotal_amount/oneOf[#/components/schemas/BenefitPointsProportionalOrderItemsCalculation]/applicable_to/items/product` response property `oneOf` list for the response status `200` - …12 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/benefits/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/benefits/get)