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

# getCustomerVipTier

> Retrieve the current VIP tier for the logged-in customer.

Retrieve the VIP tier assigned to the currently logged-in customer, along with their progress value toward the next tier.

## Usage

```javascript theme={null}
MageSDK.getCustomerVipTier().then(function(resp) {
  if (resp.success) {
    console.log(resp.data.tier);
  }
});
```

## Response

<ResponseField name="success" type="boolean">
  Whether the request was successful.
</ResponseField>

<ResponseField name="data.tier" type="object | null">
  The customer's current VIP tier, or `null` if no tier is assigned.

  <Expandable title="Tier properties">
    <ResponseField name="id" type="string">
      The tier ID.
    </ResponseField>

    <ResponseField name="name" type="string">
      Display name of the tier (e.g. "Gold").
    </ResponseField>

    <ResponseField name="description" type="string | null">
      Description of the tier, or `null` if not set.
    </ResponseField>

    <ResponseField name="pointsRequired" type="number">
      Points required to reach this tier.
    </ResponseField>

    <ResponseField name="pointsMultiplier" type="number">
      Points earning multiplier for this tier.
    </ResponseField>

    <ResponseField name="badgeImageUrl" type="string | null">
      URL of the tier badge image, or `null` if not set.
    </ResponseField>

    <ResponseField name="badgeColor" type="string | null">
      Hex color code for the tier badge, or `null` if not set.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="data.tierProgressValue" type="number">
  The customer's current progress value toward the next tier.
</ResponseField>

## Sample response

```json theme={null}
{
  "success": true,
  "data": {
    "tier": {
      "id": "tier_abc",
      "name": "Gold",
      "description": "Our most valued customers",
      "pointsRequired": 500,
      "pointsMultiplier": 1.5,
      "badgeImageUrl": null,
      "badgeColor": "#FFD700"
    },
    "tierProgressValue": 1200
  }
}
```