---
updatedAt: 2025-07-29T18:42:37.000Z
agentTools:
  projectIndex: https://dev.tapcart.com/llms.txt
---

# loyalty/tiers

fetches loyalty tiers

#### Fields

### `appId` • *string* <span className="required-tag">required</span>

The unique identifier for the store. This value is accessible at the block level via `tapcartData?.appId`

***

#### Description

Retrieves tier and point system details from the loyalty provider.

#### Example

```javascript App Studio - React.js
Tapcart.action("loyalty/tiers", {
  appId: "AbC123XyZ9",
});

// Alternatively
Tapcart.actions?.getLoyaltyTiers({ 
  appId: tapcartData?.appId 
})
```

#### Response

No response data is returned directly. Instead, the result is stored in the app variables under `Tapcart.loyalty.tiers`.

> ⚠️ Important Notes
>
> * This data becomes available upon customer login `customer/login` and can be accessed under app variables at `Tapcart.loyalty.tiers`.