> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thanx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Reward Templates

> Returns published reward templates for a merchant

<Info>
  Scope required: `rewards.issue`
</Info>

This endpoint returns all published reward templates for a given merchant.
Reward templates define the type of reward that can be issued through a
campaign. Use these templates when creating campaigns to specify what reward
each variant will offer.

### Parameters

<ParamField query="merchant_id" type="string" required>
  Merchant ID
</ParamField>

<Snippet file="pagination/params.mdx" />

### Response

<ResponseField name="id" type="string">
  Reward template ID
</ResponseField>

<ResponseField name="name" type="string">
  Template name
</ResponseField>

<ResponseField name="type" type="string">
  Reward type
</ResponseField>

<ResponseField name="subtype" type="string">
  Reward subtype
</ResponseField>

<ResponseField name="description" type="string">
  Short description of the reward
</ResponseField>

<ResponseField name="fine_print" type="string">
  Terms and conditions
</ResponseField>

<ResponseField name="discount" type="hash">
  Discount details
</ResponseField>

<ResponseField name="redemption_venue" type="string">
  Where the reward can be redeemed
</ResponseField>

<ResponseField name="images" type="hash">
  Image URLs for the reward template
</ResponseField>

<Snippet file="pagination/response.mdx" />

<RequestExample>
  ```bash List Reward Templates theme={null}
  curl https://api.thanxsandbox.com/partner/reward_templates?merchant_id={merchant_id} \
    -X GET \
    -H 'X-ClientId: {client_id}' \
    -H 'Accept-Version: v4.0' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer {access_token}'
  ```
</RequestExample>

<ResponseExample>
  ```json Response Example theme={null}
  {
    "reward_templates": [
      {
        "id": "abc123def456",
        "name": "Free Coffee",
        "type": "discount",
        "subtype": "free_item",
        "description": "One free coffee, any size",
        "fine_print": "Valid at participating locations",
        "discount": {
          "type": "free_item",
          "value": null
        },
        "redemption_venue": "in_store",
        "images": {
          "default": "https://images.thanx.com/reward_template.png"
        }
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 10,
      "total_pages": 1
    }
  }
  ```
</ResponseExample>