---
title: "List Loyalty Tier Rewards"
method: GET
path: "/v1/loyalties/{campaignId}/tiers/{loyaltyTierId}/rewards"
tags: ["Loyalties"]
---

# List Loyalty Tier Rewards

`GET /v1/loyalties/{campaignId}/tiers/{loyaltyTierId}/rewards`

Get available rewards for a given tier.

## Response `200`

Returns a dictionary of loyalty tier reward objects.

- LoyaltiesTiersRewardsListResponseBody — Response body schema for **GET** `v1/loyalties/{campaignId}/tiers/{loyaltyTierId}/rewards`.
  - `object` string, required — The type of the object represented by JSON. This object stores information about loyalty tier rewards in a dictionary.
  - `data_ref` string, required — Identifies the name of the attribute that contains the array of loyalty tier reward objects.
  - `data` LoyaltiesLoyaltyTierReward[], required — Contains array of loyalty tier reward objects.
    - `reward` Reward, required
      - `id` string, required — Unique reward ID, assigned by Voucherify.
      - `name` string, required — Reward name.
      - `stock` integer, nullable, required — Configurable for **material rewards**. The number of units of the product that you want to share as a reward. Use this parameter to code a stock-taking logic.
      - `redeemed` integer, nullable, required — Defines the number of already invoked (successful) reward redemptions.
      - `attributes` object — These properties are configurable for **material rewards**.
        - `image_url` string — The HTTPS URL pointing to the .png or .jpg file.
        - `description` string — An arbitrary string that you can attach to a material reward.
      - `metadata` object, required — The metadata object stores all custom attributes assigned to the reward. A set of key/value pairs that you can attach to a reward object. It can be useful for storing additional information about the reward in a structured format.
      - `type` 'CAMPAIGN' | 'COIN' | 'MATERIAL', required — Reward type.
      - `parameters` union
        - RewardTypeCampaign
          - `campaign` object, required — Objects stores information about the campaign related to the reward.
            - `id` string, required — Unique campaign ID, assigned by Voucherify.
            - `balance` integer — The number of points to be added to a loyalty card or the amount to be added to the current balance on the gift card. For gift cards, the value is multiplied by 100 to precisely represent 2 decimal places. For example, $100 amount is written as 10000.
            - `type` 'DISCOUNT_COUPONS' | 'GIFT_VOUCHERS' | 'LOYALTY_PROGRAM', required — Campaign type.
        - RewardTypeCoin
          - `coin` object, required — Defines the ratio by mapping the number of loyalty points in points_ratio to a predefined cash amount in exchange_ratio.
            - `exchange_ratio` number, required — The cash equivalent of the points defined in the points_ratio property.
            - `points_ratio` integer — The number of loyalty points that will map to the predefined cash amount defined by the exchange_ratio property.
        - RewardTypeMaterial
          - `product` object, required — Contains information about the product given as a reward.
            - `id` string, required — Unique product ID, assigned by Voucherify.
            - `sku_id` string, nullable — Unique SKU ID, assigned by Voucherify, of the SKU given as a reward.
      - `created_at` string, date-time, required — Timestamp representing the date and time when the reward was created. The value is shown in the ISO 8601 format.
      - `updated_at` string, date-time, nullable, required — Timestamp representing the date and time when the reward was updated. The value is shown in the ISO 8601 format.
      - `object` 'reward', required — The type of the object represented by the JSON. This object stores information about the reward.
    - `assignment` RewardAssignment, required
      - `id` string, required — Unique reward assignment ID, assigned by Voucherify.
      - `reward_id` string, required — Associated reward ID.
      - `created_at` string, date-time, required — Timestamp representing the date and time when the reward assignment was created. The value is shown in the ISO 8601 format.
      - `updated_at` string, date-time, nullable, required — Timestamp representing the date and time when the reward assignment was updated. The value is shown in the ISO 8601 format.
      - `object` 'reward_assignment', required — The type of the object represented by the JSON. This object stores information about the reward assignment.
      - `related_object_id` string, required — Related object ID to which the reward was assigned.
      - `related_object_type` 'campaign', required — Related object type to which the reward was assigned.
      - `parameters` object — Defines the cost of the reward.
        - `loyalty` object, required — Defines the equivalent points value of the reward.
          - `points` integer — The number of points required to redeem the reward.
          - `auto_redeem` boolean, nullable — Determines if the reward is redeemed automatically when the customer reaches the sufficient number of points to redeem it. Value `true` means that the automatic reward redemption is active. Only one reward can be set to be redeemed automatically in a loyalty campaign, i.e. only one can have the value `true`.
    - `object` 'loyalty_tier_reward', required — The type of the object represented by JSON. This object stores information about the loyalty tier reward.
  - `total` integer, required — Total number of loyalty tier reward objects.

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-api-async-actions/revisions/4982266e0494/schema)