Skip to main content
The Profile Tier API reads and manages the tier a Profile currently holds, triggers per-profile tier recalculation, and queues bulk recalculations across many profiles at once. For a conceptual overview of how tiers work, including the Attain and Maintain mechanics, see Tiers.

​
Endpoint patterns

Most Profile Tier endpoints are profile-scoped:
  • GET /v3/profiles/{profile}/tiers: read the tier a Profile currently holds
  • PUT /v3/profiles/{profile}/tiers/assign: manually assign a tier to a Profile
  • GET /v3/profiles/{profile}/tiers/calculate: recalculate the tier for a single Profile
A global batch endpoint is also available for recalculating many profiles at once:
  • POST /v3/profile/tiers/calculate/batch.json: queue tier recalculations for a list of profiles
Use the global batch endpoint when you need to recalculate tiers across a large set of profiles, for example after adjusting Tier Point values or importing historical transactions. Each entry requires a profile_id. Processing runs asynchronously on a low-priority queue.