> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bonifiq.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Tiers (Níveis)

> Endpoints para consultar níveis de fidelidade

Os endpoints de tiers permitem consultar os níveis de fidelidade disponíveis no programa e o progresso do cliente.

## Status de Autenticação dos Endpoints

| Endpoint                | Status  |
| ----------------------- | ------- |
| `GET /pub/widget/tiers` | Público |

***

## Listar Tiers

Retorna todos os níveis de fidelidade disponíveis no programa.

### Requisição

`GET /pub/widget/tiers`

**Headers**

<ParamField header="X-Bq-Tenant" type="string" required>
  Identificador público da loja.
</ParamField>

### Exemplo

```bash theme={null}
curl -X GET "https://api.bonifiq.com.br/pub/widget/tiers" \
  -H "X-Bq-Tenant: {tenant_key}"
```

### Resposta

```json theme={null}
{
  "HasError": false,
  "Message": null,
  "Item": [
    {
      "Id": 1,
      "Name": "Bronze",
      "Color": "#CD7F32",
      "MinPoints": 0,
      "MaxPoints": 999,
      "Benefits": [
        "Acesso a recompensas básicas",
        "1 ponto a cada R$ 1,00 gasto"
      ],
      "Icon": "bronze-medal",
      "IsCurrent": false
    },
    {
      "Id": 2,
      "Name": "Prata",
      "Color": "#C0C0C0",
      "MinPoints": 1000,
      "MaxPoints": 4999,
      "Benefits": [
        "Acesso a recompensas exclusivas",
        "1.5 pontos a cada R$ 1,00 gasto",
        "Frete grátis acima de R$ 100"
      ],
      "Icon": "silver-medal",
      "IsCurrent": true
    },
    {
      "Id": 3,
      "Name": "Ouro",
      "Color": "#FFD700",
      "MinPoints": 5000,
      "MaxPoints": 9999,
      "Benefits": [
        "Acesso a todas as recompensas",
        "2 pontos a cada R$ 1,00 gasto",
        "Frete grátis",
        "Acesso antecipado a promoções"
      ],
      "Icon": "gold-medal",
      "IsCurrent": false
    },
    {
      "Id": 4,
      "Name": "Diamante",
      "Color": "#B9F2FF",
      "MinPoints": 10000,
      "MaxPoints": null,
      "Benefits": [
        "Benefícios exclusivos VIP",
        "3 pontos a cada R$ 1,00 gasto",
        "Frete grátis expresso",
        "Atendimento prioritário",
        "Presentes especiais"
      ],
      "Icon": "diamond",
      "IsCurrent": false
    }
  ]
}
```

<Note>
  O campo `IsCurrent` indica qual é o tier atual do cliente autenticado. As informações detalhadas do tier atual também estão disponíveis no endpoint `/pub/widget/customer/info`.
</Note>