Skip to main content
GET
/
v2
/
loyalties
/
programs
/
{id}
/
tier-structures
List tier structure assignments for a program
curl --request GET \
  --url https://api.voucherify.io/v2/loyalties/programs/{id}/tier-structures \
  --header 'Authorization: Bearer <token>' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>'
{
  "data": [
    {
      "tier_structure_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "object": "<string>"
    }
  ],
  "cursor": {
    "next": "<string>",
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "object": "<string>"
}

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 program identifier

Pattern: ^lprg_[a-f0-9]+$

Query Parameters

​
limit
integer
default:10

Maximum number of results to return (1-100, default 10)

Required range: 1 <= x <= 100
​
order

Sort order for tier structure assignments

Available options:
-created_at,
created_at
​
cursor
string

Cursor for pagination

Pattern: ^lcrstsa_[a-f0-9]+$

Response

Paginated list of tier structure assignments

​
data
object[]
​
cursor
object

Cursor for fetching the next page of results.

​
object
string
Allowed value: "list"
Last modified on June 2, 2026