Tier Structures

List tier structure activities

Changed on Oct 14, 2026

<Info>

<Badge color="gray">Documentation in progress</Badge>

This documentation is in progress. The parameters, fields, request and response bodies, and other data may be subject to change. If you need more information or you want to share feedback, contact Voucherify support or your Technical Account Manager.

</Info>

Returns a cursor-paginated list of activities recorded for the tier structure (creation, updates, state transitions, assignments, and nested tier changes). The same field cannot be requested in both ascending and descending order at once. Default order is -created_at.

get/v2/loyalties/tier-structures/{tierStructureId}/activities

Request

Base URL
https://api.voucherify.io
URL
https://api.voucherify.io/v2/loyalties/tier-structures/{tierStructureId}/activities
Auth
- API key in header X-App-Id and API key in header X-App-Token
- or HTTP bearer

Query parameters

number

string

Limits the page size to an integer from 1 to 100. Defaults to 10. A numeric string is accepted and rounded to the nearest integer.

'created_at' | '-created_at'

string[]

Orders the results. Accepts one value or an array. Prefix a field with - for descending order. Defaults to -created_at. The same field cannot be used in both directions. Rows with the same sort value are then ordered by id ascending.

cursorstring nullable

Continues pagination. Pass the cursor.next value from a previous response. Format lcrsats_[a-f0-9]+. The cursor matches the filters and order of that response.

junction'AND' | 'OR' nullable

Joins the field filters. Allowed values are AND and OR. Defaults to AND.

Filters the results. Pass a deep object, for example filters[type][conditions][$is]=vl.tier_structure.created. Fields combine through junction, which defaults to AND. Omit filters to apply no field filter.

Response

Paginated list of tier structure activities.

object'list' required

Object type discriminator. Always list.

Changes

Oct 14, 2026v2d29b33490051 Revision changes
- breaking
  the /////// response's property type changed from object to no type for status
- breaking
  the /////// response's property type changed from object to no type for status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- warning
  removed the optional property //////// from the response with the status
- info
  added subschema #2 to the /////// response property allOf list for the response status
- info
  added subschema #2 to the /////// response property allOf list for the response status
Oct 14, 2026v2be14b3318eb3 Revision changes
- breaking
  the /////// response's property type changed from no type to object for status
- breaking
  the /////// response's property type changed from no type to object for status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  removed subschema #2 from the /////// response property allOf list for the response status
- info
  removed subschema #2 from the /////// response property allOf list for the response status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status
- info
  added the required property //////// to the response with the status

Operation history (16 revisions)

List tier structure activities

Request

Query parameters

Response 200OK

Changes

Response