List VIP tiers

GET /tiers


Scope	`program:read`
Customer session token	Accepted with the `read` scope, for the token’s own customer
Rate limit class	`read` (limits)
Idempotency key	Not used
MCP tool	`charm_list_tiers`

Response `200`

Returns TierList.

Field	Type	Description
`data`	array of Tier
`next_cursor`	string or null	Pass as `cursor` to fetch the next page; null on the last page. (nullable)
`has_more`	boolean	True when another page exists.
`enabled`	boolean	Whether VIP tiers are on.
`qualification`	object or null	(nullable)

{
  "data": [
    {
      "id": "id",
      "name": "Gold",
      "handle": "handle",
      "name_translations": {},
      "threshold": 1,
      "points_multiplier": 120,
      "combine": "any",
      "criteria": [
        null
      ],
      "benefits": [
        null
      ]
    }
  ],
  "next_cursor": null,
  "has_more": true,
  "enabled": true,
  "qualification": {
    "basis": "points",
    "period": "lifetime",
    "period_months": 1
  }
}

Example

curl -X GET "https://charm.appfleece.app/api/v1/tiers" \
  -H "Authorization: Bearer chrm_live_..."

Errors

unauthorized · invalid_token · token_expired · insufficient_scope · access_required · validation_error · rate_limited

Every error body carries code, message, request_id and a doc_url pointing at the matching entry in the error catalog.