> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://docs.bloy.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Rewards

### Get customer rewards
Retrieve a list of rewards earned by a customer
`GET` `/rest-api/v1/rewards` 

**Query parameters**

| Name | Type | Description |
| ---- |
| customerIdentifier | string | Search by Shopify customer ID or customer email |
| page | int | Page number |
| pageSize | int | Number of results per page |

**Example request**
```
curl --request GET \
     --url 'https://api.bloy.io/rest-api/v1/rewards?customerIdentifier=customer@example.com&page=1&pageSize=20' \
     --header 'Authorization: Bearer YourApiKeyGoesHere'

```

**Example response**
```
{
  "success": true,
  "message": "OK",
  "rewards": [
    {
      "_id": "664f1a2b3c4d5e6f7a8b9c20",
      "discountCodeId": "gid://shopify/DiscountCodeNode/123456789",
      "discountCode": "BLOY-AB12CD34",
      "description": "$5 Off",
      "discountValue": 5,
      "redeemType": "amount",
      "status": "available",
      "createdByModule": "publicApi",
      "createdAt": "2026-06-08T07:30:00.000Z",
      "updatedAt": "2026-06-08T07:30:00.000Z"
    }
  ]
}
```

**Note: **`redeemType` can be one of: `amount`, `percentage`, `shipping`, `free_product`, `store_credit`. If no customer matches `customerIdentifier`, the API returns `"rewards": []` instead of a `404` error.