Skip to main content
GET
/
v2
/
loyalties
/
tier-structures
/
{id}
/
tiers
List Tiers
curl --request GET \
  --url https://api.voucherify.io/v2/loyalties/tier-structures/{id}/tiers \
  --header 'Authorization: Bearer <token>' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>'
{
  "data": [
    {
      "id": "<string>",
      "tier_structure_id": "<string>",
      "name": "<string>",
      "downgrade": {},
      "metadata": {},
      "created_at": "2023-11-07T05:31:56Z",
      "qualification_rules": {
        "min_value": 1,
        "max_value": 1,
        "segment": {
          "id": "<string>"
        }
      },
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "cursor": {
    "next": "<string>",
    "expires_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
X-App-Id
string
header
required
​
X-App-Token
string
header
required

Path Parameters

​
id
string
required

Unique tier structure identifier.

Query Parameters

​
limit
integer
default:10

Maximum number of results to return (1-100).

Required range: 1 <= x <= 100
​
order
enum<string>[]

Sort order. Prefix with - for descending. Default: -created_at.

Available options:
created_at,
-created_at,
name,
-name
​
cursor
string

Cursor for pagination. Obtained from a previous list response.

Response

List of tiers

​
data
object[]
required
​
object
enum<string>
required
Available options:
list
​
cursor
object

Cursor for fetching the next page of results.

Last modified on June 2, 2026