---
title: "GET /v2/customers/{merchant_id}/available_rewards"
method: GET
path: "/v2/customers/{merchant_id}/available_rewards"
tags: ["customers"]
---

# GET /v2/customers/{merchant_id}/available_rewards

`GET /v2/customers/{merchant_id}/available_rewards`

## Path parameters

- `merchant_id` string, required

## Query parameters

- `site_id` number
- `country` string

## Response `200`

200

- CustomersListAvailableRewardsResponseBody
  - `rewards` union[], required
    - union
      - object
        - `id` number, required
        - `title` string, required
        - `title_template` string, nullable, required
        - `description` string, nullable, required
        - `sort_key` number, required
        - `content` object, required
        - `point_cost` number, required
        - `method` 'voucher', required
        - `discount_type` 'flat' | 'percentage', required
        - `discount_amount` number, required
        - `minimum_spend` number, nullable, required
        - `usage_limit` number, required
        - `min_redemption_amount` 1, required
        - `max_redemption_amount` 1, required
        - `max_free_shipping` unknown, required
        - `site_id` number, required
        - `target_site` object, required
          - `id` number, required
          - `name` string, required
          - `url` string, required
        - `order_type` 'subscription', required
        - `target_type` 'all', required
        - `target_collections` object[], required
          - `id` union
            - number
            - string
          - `url` string
          - `restriction_text` string
        - `target_products` object[], required
          - `id` union
            - number
            - string
          - `variant_id` number
          - `sku` string
          - `url` string
          - `image_url` string
          - `title` string
          - `handle` string
          - `inventory_count` number, nullable, required — The current inventory count of this product variant, or `null` if inventory is not tracked. If the count is zero, you should ensure it is not selectable by customers when redeeming the reward
          - `sort_key` number, required
        - `session_options` unknown, required
        - `auto_refund_seconds` unknown, required
        - `expiry_options` object, required
          - `kind` 'does_not_expire', required
          - `seconds` unknown, required
        - `redeemable_expiry_options` unknown, required
        - `supported_channels` string[], required
        - `available_countries` string[], nullable, required
        - `kind` 'active_subscription_discount_voucher', required
        - `recurring_cycle_limit` number, nullable, required
      - object
        - `id` number, required
        - `title` string, required
        - `title_template` string, nullable, required
        - `description` string, nullable, required
        - `sort_key` number, required
        - `content` object, required
        - `point_cost` number, required
        - `method` 'buy_with_points' | 'function', required
        - `discount_type` 'percentage', required
        - `discount_amount` number, required
        - `minimum_spend` number, nullable, required
        - `usage_limit` 1, required
        - `min_redemption_amount` 1, required
        - `max_redemption_amount` 1, required
        - `max_free_shipping` unknown, required
        - `site_id` number, required
        - `target_site` object, required
          - `id` number, required
          - `name` string, required
          - `url` string, required
        - `order_type` 'all', required
        - `target_type` 'product', required
        - `target_collections` object[], required
          - `id` union
            - number
            - string
          - `url` string
          - `restriction_text` string
        - `target_products` object[], required
          - `id` union
            - number
            - string
          - `variant_id` number
          - `sku` string
          - `url` string
          - `image_url` string
          - `title` string
          - `handle` string
          - `inventory_count` number, nullable, required — The current inventory count of this product variant, or `null` if inventory is not tracked. If the count is zero, you should ensure it is not selectable by customers when redeeming the reward
          - `sort_key` number, required
        - `session_options` object, required
          - `kind` 'cart', required
          - `session_limit` 1, nullable, required
        - `auto_refund_seconds` number, required
        - `expiry_options` object, required
          - `kind` 'duration', required
          - `seconds` number, required
        - `redeemable_expiry_options` unknown, required
        - `supported_channels` string[], required
        - `available_countries` string[], nullable, required
        - `kind` 'product_cart', required
        - `minimum_requirements` union
          - BuyWithPointsRewardMinimumRequirementsCost
            - `type` 'cost', required
            - `cost` number, required
          - BuyWithPointsRewardMinimumRequirementsQuantity
            - `type` 'quantity', required
            - `quantity` number, required
      - object
        - `id` number, required
        - `title` string, required
        - `title_template` string, nullable, required
        - `description` string, nullable, required
        - `sort_key` number, required
        - `content` object, required
        - `point_cost` number, required
        - `method` 'voucher', required
        - `discount_type` 'flat' | 'percentage', required
        - `discount_amount` number, required
        - `minimum_spend` number, nullable, required
        - `usage_limit` number, required
        - `min_redemption_amount` 1, required
        - `max_redemption_amount` 1, required
        - `max_free_shipping` unknown, required
        - `site_id` number, required
        - `target_site` object, required
          - `id` number, required
          - `name` string, required
          - `url` string, required
        - `order_type` 'all' | 'one_time' | 'subscription', required
        - `target_type` 'all' | 'collection', required
        - `target_collections` object[], required
          - `id` union
            - number
            - string
          - `url` string
          - `restriction_text` string
        - `target_products` object[], required
          - `id` union
            - number
            - string
          - `variant_id` number
          - `sku` string
          - `url` string
          - `image_url` string
          - `title` string
          - `handle` string
          - `inventory_count` number, nullable, required — The current inventory count of this product variant, or `null` if inventory is not tracked. If the count is zero, you should ensure it is not selectable by customers when redeeming the reward
          - `sort_key` number, required
        - `session_options` unknown, required
        - `auto_refund_seconds` unknown, required
        - `expiry_options` object, required
          - `kind` 'does_not_expire', required
          - `seconds` unknown, required
        - `redeemable_expiry_options` object, nullable, required
          - `after_duration` object, required
            - `seconds` number, required
        - `supported_channels` string[], required
        - `available_countries` string[], nullable, required
        - `kind` 'cart_discount_voucher', required
        - `recurring_cycle_limit` number, nullable, required
        - `supports_active_subscriptions` boolean
      - object
        - `id` number, required
        - `title` string, required
        - `title_template` string, nullable, required
        - `description` string, nullable, required
        - `sort_key` number, required
        - `content` object, required
        - `point_cost` number, required
        - `method` 'voucher', required
        - `discount_type` 'flat', required
        - `discount_amount` number, required
        - `minimum_spend` unknown, required
        - `usage_limit` 1, required
        - `min_redemption_amount` number, required
        - `max_redemption_amount` number, required
        - `max_free_shipping` unknown, required
        - `site_id` number, required
        - `target_site` object, required
          - `id` number, required
          - `name` string, required
          - `url` string, required
        - `order_type` 'all' | 'one_time', required
        - `target_type` 'all' | 'collection', required
        - `target_collections` object[], required
          - `id` union
            - number
            - string
          - `url` string
          - `restriction_text` string
        - `target_products` object[], required
          - `id` union
            - number
            - string
          - `variant_id` number
          - `sku` string
          - `url` string
          - `image_url` string
          - `title` string
          - `handle` string
          - `inventory_count` number, nullable, required — The current inventory count of this product variant, or `null` if inventory is not tracked. If the count is zero, you should ensure it is not selectable by customers when redeeming the reward
          - `sort_key` number, required
        - `session_options` object, required
          - `kind` 'checkout', required
          - `session_limit` 1, required
        - `auto_refund_seconds` number, required
        - `expiry_options` object, required
          - `kind` 'duration', required
          - `seconds` number, required
        - `redeemable_expiry_options` unknown, required
        - `supported_channels` string[], required
        - `available_countries` string[], nullable, required
        - `kind` 'checkout_redemption', required
        - `redemption_amount_step` number, nullable, required
        - `fixed_redemption_amounts` number[], nullable, required
        - `min_spend_after_discount` number, nullable, required
        - `min_spend_before_discount` number, nullable, required
        - `hide_unavailable_discounts` boolean
      - object
        - `id` number, required
        - `title` string, required
        - `title_template` string, nullable, required
        - `description` string, nullable, required
        - `sort_key` number, required
        - `content` object, required
        - `point_cost` number, required
        - `method` 'voucher', required
        - `discount_type` 'flat' | 'percentage', required
        - `discount_amount` number, required
        - `minimum_spend` number, nullable, required
        - `usage_limit` 1, required
        - `min_redemption_amount` 1, required
        - `max_redemption_amount` 1, required
        - `max_free_shipping` unknown, required
        - `site_id` number, required
        - `target_site` object, required
          - `id` number, required
          - `name` string, required
          - `url` string, required
        - `order_type` 'all', required
        - `target_type` 'collection', required
        - `target_collections` object[], required
          - `id` union
            - number
            - string
          - `url` string
          - `restriction_text` string
        - `target_products` object[], required
          - `id` union
            - number
            - string
          - `variant_id` number
          - `sku` string
          - `url` string
          - `image_url` string
          - `title` string
          - `handle` string
          - `inventory_count` number, nullable, required — The current inventory count of this product variant, or `null` if inventory is not tracked. If the count is zero, you should ensure it is not selectable by customers when redeeming the reward
          - `sort_key` number, required
        - `session_options` unknown, required
        - `auto_refund_seconds` unknown, required
        - `expiry_options` object, required
          - `kind` 'does_not_expire', required
          - `seconds` unknown, required
        - `redeemable_expiry_options` object, nullable, required
          - `after_duration` object, required
            - `seconds` number, required
        - `supported_channels` string[], required
        - `available_countries` string[], nullable, required
        - `kind` 'collection_discount_voucher', required
      - object
        - `id` number, required
        - `title` string, required
        - `title_template` string, nullable, required
        - `description` string, nullable, required
        - `sort_key` number, required
        - `content` object, required
          - `fulfilment_instructions` string, nullable, required
        - `point_cost` number, required
        - `method` 'store_fulfilment' | 'voucher', required
        - `discount_type` 'custom', required
        - `discount_amount` unknown, required
        - `minimum_spend` unknown, required
        - `usage_limit` number, required
        - `min_redemption_amount` number, required
        - `max_redemption_amount` number, required
        - `max_free_shipping` unknown, required
        - `site_id` number, required
        - `target_site` object, required
          - `id` number, required
          - `name` string, required
          - `url` string, required
        - `order_type` 'all', required
        - `target_type` 'custom', required
        - `target_collections` object[], required
          - `id` union
            - number
            - string
          - `url` string
          - `restriction_text` string
        - `target_products` object[], required
          - `id` union
            - number
            - string
          - `variant_id` number
          - `sku` string
          - `url` string
          - `image_url` string
          - `title` string
          - `handle` string
          - `inventory_count` number, nullable, required — The current inventory count of this product variant, or `null` if inventory is not tracked. If the count is zero, you should ensure it is not selectable by customers when redeeming the reward
          - `sort_key` number, required
        - `session_options` unknown, required
        - `auto_refund_seconds` unknown, required
        - `expiry_options` object, required
          - `kind` 'does_not_expire', required
          - `seconds` unknown, required
        - `redeemable_expiry_options` unknown, required
        - `supported_channels` string[], required
        - `available_countries` string[], nullable, required
        - `kind` 'custom', required
      - object
        - `id` number, required
        - `title` string, required
        - `title_template` string, nullable, required
        - `description` string, nullable, required
        - `sort_key` number, required
        - `content` object, required
        - `point_cost` number, required
        - `method` 'voucher', required
        - `discount_type` 'percentage', required
        - `discount_amount` 100, required
        - `minimum_spend` number, nullable, required
        - `usage_limit` 1, required
        - `min_redemption_amount` 1, required
        - `max_redemption_amount` 1, required
        - `max_free_shipping` number, nullable, required
        - `site_id` number, required
        - `target_site` object, required
          - `id` number, required
          - `name` string, required
          - `url` string, required
        - `order_type` 'all', required
        - `target_type` 'shipping', required
        - `target_collections` object[], required
          - `id` union
            - number
            - string
          - `url` string
          - `restriction_text` string
        - `target_products` object[], required
          - `id` union
            - number
            - string
          - `variant_id` number
          - `sku` string
          - `url` string
          - `image_url` string
          - `title` string
          - `handle` string
          - `inventory_count` number, nullable, required — The current inventory count of this product variant, or `null` if inventory is not tracked. If the count is zero, you should ensure it is not selectable by customers when redeeming the reward
          - `sort_key` number, required
        - `session_options` unknown, required
        - `auto_refund_seconds` unknown, required
        - `expiry_options` object, required
          - `kind` 'does_not_expire', required
          - `seconds` unknown, required
        - `redeemable_expiry_options` object, nullable, required
          - `after_duration` object, required
            - `seconds` number, required
        - `supported_channels` string[], required
        - `available_countries` string[], nullable, required
        - `kind` 'free_shipping_voucher', required
      - object
        - `id` number, required
        - `title` string, required
        - `title_template` string, nullable, required
        - `description` string, nullable, required
        - `sort_key` number, required
        - `content` object, required
        - `point_cost` number, required
        - `method` 'gift_card', required
        - `discount_type` 'flat', required
        - `discount_amount` number, required
        - `minimum_spend` unknown, required
        - `usage_limit` 1, required
        - `min_redemption_amount` 1, required
        - `max_redemption_amount` 1, required
        - `max_free_shipping` unknown, required
        - `site_id` number, required
        - `target_site` object, required
          - `id` number, required
          - `name` string, required
          - `url` string, required
        - `order_type` 'all', required
        - `target_type` 'all', required
        - `target_collections` object[], required
          - `id` union
            - number
            - string
          - `url` string
          - `restriction_text` string
        - `target_products` object[], required
          - `id` union
            - number
            - string
          - `variant_id` number
          - `sku` string
          - `url` string
          - `image_url` string
          - `title` string
          - `handle` string
          - `inventory_count` number, nullable, required — The current inventory count of this product variant, or `null` if inventory is not tracked. If the count is zero, you should ensure it is not selectable by customers when redeeming the reward
          - `sort_key` number, required
        - `session_options` unknown, required
        - `auto_refund_seconds` unknown, required
        - `expiry_options` object, required
          - `kind` 'does_not_expire', required
          - `seconds` unknown, required
        - `redeemable_expiry_options` object, nullable, required
          - `after_duration` object, required
            - `seconds` number, required
        - `supported_channels` string[], required
        - `available_countries` string[], nullable, required
        - `kind` 'gift_card', required
      - object
        - `id` number, required
        - `title` string, required
        - `title_template` string, nullable, required
        - `description` string, nullable, required
        - `sort_key` number, required
        - `content` object, required
        - `point_cost` number, required
        - `method` 'voucher', required
        - `discount_type` 'percentage', required
        - `discount_amount` number, required
        - `minimum_spend` number, nullable, required
        - `usage_limit` 1, required
        - `min_redemption_amount` 1, required
        - `max_redemption_amount` 1, required
        - `max_free_shipping` unknown, required
        - `site_id` number, required
        - `target_site` object, required
          - `id` number, required
          - `name` string, required
          - `url` string, required
        - `order_type` 'all', required
        - `target_type` 'product', required
        - `target_collections` object[], required
          - `id` union
            - number
            - string
          - `url` string
          - `restriction_text` string
        - `target_products` object[], required
          - `id` union
            - number
            - string
          - `variant_id` number
          - `sku` string
          - `url` string
          - `image_url` string
          - `title` string
          - `handle` string
          - `inventory_count` number, nullable, required — The current inventory count of this product variant, or `null` if inventory is not tracked. If the count is zero, you should ensure it is not selectable by customers when redeeming the reward
          - `sort_key` number, required
        - `session_options` unknown, required
        - `auto_refund_seconds` unknown, required
        - `expiry_options` object, required
          - `kind` 'does_not_expire', required
          - `seconds` unknown, required
        - `redeemable_expiry_options` object, nullable, required
          - `after_duration` object, required
            - `seconds` number, required
        - `supported_channels` string[], required
        - `available_countries` string[], nullable, required
        - `kind` 'product_discount_voucher', required
      - object
        - `id` number, required
        - `title` string, required
        - `title_template` string, nullable, required
        - `description` string, nullable, required
        - `sort_key` number, required
        - `content` object, required
        - `point_cost` number, required
        - `method` 'subscription_buy_with_points', required
        - `discount_type` 'percentage', required
        - `discount_amount` number, required
        - `minimum_spend` number, nullable, required
        - `usage_limit` number, required
        - `min_redemption_amount` 1, required
        - `max_redemption_amount` 1, required
        - `max_free_shipping` unknown, required
        - `site_id` number, required
        - `target_site` object, required
          - `id` number, required
          - `name` string, required
          - `url` string, required
        - `order_type` 'subscription', required
        - `target_type` 'product', required
        - `target_collections` object[], required
          - `id` union
            - number
            - string
          - `url` string
          - `restriction_text` string
        - `target_products` object[], required
          - `id` union
            - number
            - string
          - `variant_id` number
          - `sku` string
          - `url` string
          - `image_url` string
          - `title` string
          - `handle` string
          - `inventory_count` number, nullable, required — The current inventory count of this product variant, or `null` if inventory is not tracked. If the count is zero, you should ensure it is not selectable by customers when redeeming the reward
          - `sort_key` number, required
        - `session_options` unknown, required
        - `auto_refund_seconds` number, required
        - `expiry_options` object, required
          - `kind` 'duration', required
          - `seconds` number, required
        - `redeemable_expiry_options` unknown, required
        - `supported_channels` string[], required
        - `available_countries` string[], nullable, required
        - `kind` 'subscription_buy_with_points', required

## Other responses

- `400` — Bad Request
- `401` — 401
- `403` — 403
- `404` — 404

---

[API](https://skmtc.net/loyaltylion/apis/loyaltylion-admin-api.md) · [All operations](https://skmtc.net/loyaltylion/apis/loyaltylion-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loyaltylion/loyaltylion-admin-api/revisions/4cfed13b45bc/schema)