> ## 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.

# getShopRewards

> List all available rewards for the shop.

Retrieve all rewards configured for the shop, split into regular rewards and tiered rewards (rewards locked behind VIP tiers).

## Usage

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

## Response

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

<ResponseField name="data.regularRewards" type="array">
  Rewards available to all customers.

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

    <ResponseField name="name" type="string">
      Display name of the reward.
    </ResponseField>

    <ResponseField name="description" type="string">
      Description of what the reward provides.
    </ResponseField>

    <ResponseField name="pointsCost" type="number">
      Number of points required to redeem.
    </ResponseField>

    <ResponseField name="category" type="string">
      Reward category (e.g. `"fixed"`, `"percentage"`, `"free_shipping"`).
    </ResponseField>

    <ResponseField name="discountType" type="string">
      Type of discount applied.
    </ResponseField>

    <ResponseField name="tier" type="object | null">
      VIP tier required to redeem, or `null` if available to all.
    </ResponseField>

    <ResponseField name="minimumSpend" type="string | null">
      Formatted minimum spend required to use the discount.
    </ResponseField>

    <ResponseField name="productMetadata" type="object | null">
      Product metadata for free-product rewards, or `null` for non-product rewards.

      <Expandable title="Product metadata properties">
        <ResponseField name="productId" type="string">
          The Shopify product ID.
        </ResponseField>

        <ResponseField name="productTitle" type="string">
          The product title.
        </ResponseField>

        <ResponseField name="productImage" type="string | null">
          URL of the product image.
        </ResponseField>

        <ResponseField name="productHandle" type="string | null">
          The product handle for URL construction.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="data.tieredRewards" type="array">
  Rewards restricted to specific VIP tiers. Same shape as `regularRewards`.
</ResponseField>

## Sample response

```json theme={null}
{
  "success": true,
  "data": {
    "regularRewards": [
      {
        "id": "reward_abc",
        "name": "\u00a35 off your next order",
        "description": "\u00a35 off your order",
        "pointsCost": 500,
        "category": "fixed",
        "discountType": "fixed",
        "tier": null,
        "minimumSpend": "\u00a320"
      }
    ],
    "tieredRewards": []
  }
}
```