# Tiers V2

Welcome to the Tiers API Documentation for Annex Cloud's cutting-edge loyalty program platform. Our Tiers API empowers developers, businesses, and partners to seamlessly integrate and enhance their applications with our dynamic and customizable loyalty tiers system. This API documentation serves as your comprehensive guide to understanding and implementing the Tiers API, unlocking the full potential of loyalty-driven engagement for your customers.
Whether you're looking to reward long-term patrons, incentivize higher spending, or create personalized experiences for your member base, our Tiers API offers a versatile solution that aligns with your unique business goals.

In this documentation, we will explore the core functionalities of the Tiers API. 

We will guide you through the process of retrieving tier information configured within a program, understanding their entry conditions, and outlining the retention criteria. 

Additionally, you will learn how to assign tiers to members based on your business requirements and needs.

## Get all the configured tier programs on a site.

 - [GET /tier/program/{{all}}](https://annexcloud.redocly.app/loyalty/loyalty/tiers-v2/gettierprogramall.md): This method allows you to fetch all the configured tier programs on a site. At any given time, a maximum of only ten tier programs can be configured on the site, and only one tier program can go live at a time.

## Get tier details using the program ID.

 - [GET /tier/program{{program_id}}](https://annexcloud.redocly.app/loyalty/loyalty/tiers-v2/gettierprogramprogramid.md): This endpoint retrieves all configuration details for a tier program using the program ID. It includes details such as entry conditions, tier benefits, and additional metadata. The metadata offers further insights about each tier.

## Get tier information for a loyalty member.

 - [GET /users/{{user_id}}/tier](https://annexcloud.redocly.app/loyalty/loyalty/tiers-v2/getusersuseridtier.md): This method can be used to get tier information for a member by passing the user ID. It also provides information on tier upgrades, retention, and downgrades.

## Manually assign a tier to a member.

 - [POST /tier/{{tier_id}}](https://annexcloud.redocly.app/loyalty/loyalty/tiers-v2/posttiertierid.md): This method is used to manually assign a tier to a member, qualifying them for the configured benefits associated with the assigned tier.

Note: To manually assign a tier to a member, the "Enable manual member tier assignment" flag must be enabled at the site level.