Sign in

v18

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01934981.1 MB
Tier Structures

List tier structures

<Warning>

<Badge color="yellow">BETA endpoint</Badge>

This is a work-in-progress documentation of a BETA endpoint. The parameters, fields, request and response bodies, and other data may subject to change. If you want to share feedback or improvements, contact Voucherify support or your Technical Account Manager.

</Warning>

Returns a cursor-paginated list of tier structures. The same field cannot be requested in both ascending and descending order at once. Default order is -created_at.

get/v2/loyalties/tier-structures

Query parameters

limitinteger

Maximum number of items returned per page. An integer between 1 and 100. Defaults to 10.

'-created_at' | 'created_at' | 'name' | '-name' | 'type' | '-type' | 'status' | '-status'
OR
string[]

Sort order. A single field name or an array of field names; prefix a field with - for descending order. Default is -created_at. The same field must not be requested in both ascending and descending direction at once.

cursorstring

Pagination cursor returned in the cursor.next field of a previous response. Must match the tier structures cursor id format.

junction'AND' | 'OR' nullable

Logical junction combining the field filters. Defaults to AND semantics.

Field-specific filter conditions, passed as a deep object (e.g. filters[status][conditions][$is]=ACTIVE).

Response

Paginated list of tier structures.

object'list' required

Object type discriminator. Always list.