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

# Changes to List tier structures

`GET /v2/loyalties/tier-structures`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 62 revisions.

- **2026-07-31** (v2) `703a0a42ea43` — 1 warning, 1 info
- **2026-07-17** (v2) `4cbaee5a82d5` — 8 info
- **2026-07-06** (v2) `341403eb19e5` — 14 breaking, 34 warning, 29 info

## Changes

- **2026-07-31** (v2) `703a0a42ea43` — 1 warning, 1 info
  - added the new `NO_RETENTION` enum value to the `data/items/expiration/type` response property for the response status `200`
  - removed the `NO_EXPIRATION` enum value from the `data/items/expiration/type` response property for the response status `200`
- **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` — 14 breaking, 34 warning, 29 info
  - added the pattern `^lcrsts_[a-f0-9]+$` to the `query` request parameter `cursor`
  - the response property `data/items/updated_at` became nullable for the status `200`
  - the response property `code` became optional for the status `400`
  - the response property `code` became optional for the status `500`
  - 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`
  - the `data/items/name` response property's maxLength was unset from `200` for the response status `200`
  - added `subschema #1` to the `cursor` response property `oneOf` list for the response status `200`
  - the `data/items/downgrade` response's property type changed from no type to `object` for status `200`
  - the `data/items/expiration` response's property type changed from no type to `object` for status `200`
  - the `data/items/point_earned` response's property type changed from no type to `object` for status `200`
  - removed the required property `data/items/card_definition_id` from the response with the `200` status
  - deleted the `query` request parameter `filters[created_at][conditions][$after]`
  - deleted the `query` request parameter `filters[created_at][conditions][$before]`
  - deleted the `query` request parameter `filters[created_at][conditions][$has_value]`
  - deleted the `query` request parameter `filters[created_at][conditions][$is]`
  - deleted the `query` request parameter `filters[created_at][conditions][$is_unknown]`
  - deleted the `query` request parameter `filters[created_at][conditions][$less_than]`
  - deleted the `query` request parameter `filters[created_at][conditions][$more_than]`
  - deleted the `query` request parameter `filters[id][conditions][$in]`
  - deleted the `query` request parameter `filters[id][conditions][$is]`
  - deleted the `query` request parameter `filters[id][conditions][$is_not]`
  - deleted the `query` request parameter `filters[id][conditions][$not_in]`
  - deleted the `query` request parameter `filters[junction]`
  - deleted the `query` request parameter `filters[name][conditions][$contains]`
  - deleted the `query` request parameter `filters[name][conditions][$ends_with]`
  - deleted the `query` request parameter `filters[name][conditions][$has_value]`
  - deleted the `query` request parameter `filters[name][conditions][$in]`
  - deleted the `query` request parameter `filters[name][conditions][$is]`
  - deleted the `query` request parameter `filters[name][conditions][$is_not]`
  - deleted the `query` request parameter `filters[name][conditions][$is_unknown]`
  - deleted the `query` request parameter `filters[name][conditions][$not_contain]`
  - deleted the `query` request parameter `filters[name][conditions][$not_in]`
  - deleted the `query` request parameter `filters[name][conditions][$starts_with]`
  - deleted the `query` request parameter `filters[status][conditions][$in]`
  - deleted the `query` request parameter `filters[status][conditions][$is]`
  - deleted the `query` request parameter `filters[status][conditions][$is_not]`
  - deleted the `query` request parameter `filters[status][conditions][$not_in]`
  - …37 more

---

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