--- title: "Changes to Get tier structure" method: GET path: "/v2/loyalties/tier-structures/{tierStructureId}" --- # Changes to Get tier structure `GET /v2/loyalties/tier-structures/{tierStructureId}` > Every recorded change to this operation, newest first. ## Timeline Changed in 11 of 220 revisions. - **2026-10-14** (v2) `6a418ac8b7b1`: 10 breaking, 3 warning, 1 info - **2026-10-14** (v2) `1e528b6c500d`: 1 breaking, 13 info - **2026-10-14** (v2) `ec801ade260d`: 10 breaking, 3 warning, 1 info - **2026-10-14** (v2) `84ad572f8dcb`: 1 breaking, 13 info - **2026-10-13** (v2) `24e063a72189`: 10 breaking, 3 warning, 1 info - **2026-10-13** (v2) `a1c9646d5aff`: 1 breaking, 13 info - **2026-10-13** (v2) `ed683aacf90a`: 10 breaking, 3 warning, 1 info - **2026-10-07** (v2) `338a5e34004e`: 2 info - **2026-10-01** (v2) `749b6d105462`: 1 breaking, 1 warning - **2026-08-03** (v2) `edc8ef782975`: 1 warning, 1 info - **2026-07-20** (v2) `4cbaee5a82d5`: 8 info ## Changes - **2026-10-14** (v2) `6a418ac8b7b1`: 10 breaking, 3 warning, 1 info - removed the required property `created_at` from the response with the `200` status - removed the required property `downgrade` from the response with the `200` status - removed the required property `expiration` 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 `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 `tierStructureId` - removed the optional property `point_balance` from the response with the `200` status - removed the optional property `point_earned` from the response with the `200` status - added `#/components/schemas/TierStructure` to the response body `allOf` list for the response status `200` - **2026-10-14** (v2) `1e528b6c500d`: 1 breaking, 13 info - added the new path request parameter `tierStructureId` - removed `#/components/schemas/TierStructure` from the response body `allOf` list for the response status `200` - added the optional property `point_balance` to the response with the `200` status - added the optional property `point_earned` to the response with the `200` status - added the required property `created_at` to the response with the `200` status - added the required property `downgrade` to the response with the `200` status - added the required property `expiration` 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 `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-14** (v2) `ec801ade260d`: 10 breaking, 3 warning, 1 info - removed the required property `created_at` from the response with the `200` status - removed the required property `downgrade` from the response with the `200` status - removed the required property `expiration` 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 `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 `tierStructureId` - removed the optional property `point_balance` from the response with the `200` status - removed the optional property `point_earned` from the response with the `200` status - added `#/components/schemas/TierStructure` to the response body `allOf` list for the response status `200` - **2026-10-14** (v2) `84ad572f8dcb`: 1 breaking, 13 info - added the new path request parameter `tierStructureId` - removed `#/components/schemas/TierStructure` from the response body `allOf` list for the response status `200` - added the optional property `point_balance` to the response with the `200` status - added the optional property `point_earned` to the response with the `200` status - added the required property `created_at` to the response with the `200` status - added the required property `downgrade` to the response with the `200` status - added the required property `expiration` 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 `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) `24e063a72189`: 10 breaking, 3 warning, 1 info - removed the required property `created_at` from the response with the `200` status - removed the required property `downgrade` from the response with the `200` status - removed the required property `expiration` 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 `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 `tierStructureId` - removed the optional property `point_balance` from the response with the `200` status - removed the optional property `point_earned` from the response with the `200` status - added `#/components/schemas/TierStructure` to the response body `allOf` list for the response status `200` - **2026-10-13** (v2) `a1c9646d5aff`: 1 breaking, 13 info - added the new path request parameter `tierStructureId` - removed `#/components/schemas/TierStructure` from the response body `allOf` list for the response status `200` - added the optional property `point_balance` to the response with the `200` status - added the optional property `point_earned` to the response with the `200` status - added the required property `created_at` to the response with the `200` status - added the required property `downgrade` to the response with the `200` status - added the required property `expiration` 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 `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`: 10 breaking, 3 warning, 1 info - removed the required property `created_at` from the response with the `200` status - removed the required property `downgrade` from the response with the `200` status - removed the required property `expiration` 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 `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 `tierStructureId` - removed the optional property `point_balance` from the response with the `200` status - removed the optional property `point_earned` from the response with the `200` status - added `#/components/schemas/TierStructure` 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-01** (v2) `749b6d105462`: 1 breaking, 1 warning - added the new path request parameter `tierStructureId` - deleted the `path` request parameter `id` - **2026-08-03** (v2) `edc8ef782975`: 1 warning, 1 info - added the new `NO_RETENTION` enum value to the `expiration/type` response property for the response status `200` - removed the `NO_EXPIRATION` enum value from the `expiration/type` response property for the response status `200` - **2026-07-20** (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/tier-structures/:tierStructureId/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/tier-structures/:tierStructureId/get)