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": {
        "type": "INHERIT"
      },
      "metadata": {},
      "created_at": "2023-11-07T05:31:56Z",
      "object": "tier",
      "qualification_rules": {
        "type": "POINTS",
        "min_value": 1,
        "max_value": 1,
        "segment": {
          "id": "<string>"
        }
      },
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "object": "list",
  "cursor": {
    "next": "<string>",
    "expires_at": "2023-11-07T05:31:56Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.voucherify.io/llms.txt

Use this file to discover all available pages before exploring further.

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 May 11, 2026