--- 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` ## Request - Base URL: `https://api.loyaltylion.com` - URL: `https://api.loyaltylion.com/v2/customers/{merchant_id}/available_rewards` - Auth: one of: - HTTP bearer - HTTP basic ## 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 - `featured_image_url` string, nullable - `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 - `fixed_redemption_amount_min_spends` object[], nullable, required - `amount` number, required - `min_spend_before_discount` 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 - `featured_image_url` string, nullable - `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 - `featured_image_url` string, nullable - `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 ## Changes - **2026-11-03** `69cbd7bf7128`: 2 breaking, 8 info - removed 'propertyNames' constraint from the `rewards/items/oneOf[subschema #2: Product (cart)]/content` response property for the status `200` - removed 'propertyNames' constraint from the `rewards/items/oneOf[subschema #9: Product (voucher)]/content` response property for the status `200` - added the optional property `error/code` to the response with the `401` status - added the optional property `error/code` to the response with the `403` status - …6 more [Operation history](https://skmtc.dev/loyaltylion/apis/loyaltylion-admin-api/changes/v2/customers/:merchant_id/available_rewards/get.md) --- [API](https://skmtc.dev/loyaltylion/apis/loyaltylion-admin-api.md) - [All operations](https://skmtc.dev/loyaltylion/apis/loyaltylion-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loyaltylion/apis/loyaltylion-admin-api/revisions/69cbd7bf7128?raw)