> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omneo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tier

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](/concepts/incentives/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

<Info>
  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.
</Info>