Docs
API ReferenceReference

List tier plans

GET
/tier-plans

Every live (non-archived) plan in the organization's Monetization catalog. Use the id values as tierPlanIds when provisioning. Plans assigned through the API never charge the end user -- you are expected to have billed them in your own system.

Requires the end_users:read scope.

AuthorizationBearer <token>

An organization API key, created from a Storefront's Webhooks page (Provisioning API card). The secret is shown once at creation and stored only as a hash. Keys are organization-wide and carry scopes (end_users:read, end_users:write). Rate limit: 120 requests per minute per key (sliding 60-second window).

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/tier-plans"
{  "tierPlans": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "description": "string",      "priceCents": 0,      "currency": "string",      "billingFrequency": "monthly",      "trialPeriodDays": 0,      "creditAllowance": 0,      "byokEnabled": true    }  ]}