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

# List reward policies

> Retrieve an array of reward policies.

GET/credit/policies/rewards

Retrieve an array of reward policies.

This endpoint supports [sorting and pagination](https://www.marqeta.com/docs/core-api/sorting-and-pagination.md).

## URL query parameters

| Fields | Description |
| - | - |
| count integer  Optional | Number of reward policy resources to retrieve. **Allowable Values:**  1–100 |
| start\_index integer  Optional | Sort order index of the first resource in the returned array. **Allowable Values:**  0 min |
| sort\_by string  Optional | Field on which to sort. Prefix the field name with a hyphen (`-`) to sort in descending order. Omit the hyphen to sort in ascending order. **NOTE:** You must sort using system field names such as `lastModifiedTime`, and not by the field names appearing in response bodies such as `last_modified_time`. **Allowable Values:**  `lastModifiedTime`, `-lastModifiedTime` |

## Response body

| Fields | Description |
| - | - |
| count integer  Returned | Number of resources returned. **Allowable Values:**  1-10 |
| start\_index integer  Returned | Sort order index of the first resource in the returned array. **Allowable Values:**  Any integer |
| end\_index integer  Returned | Sort order index of the last resource in the returned array. **Allowable Values:**  Any integer |
| is\_more boolean  Returned | A value of `true` indicates that more unreturned resources exist. **Allowable Values:**  `true`, `false` |
| data array of objects  Returned | List of one or more reward policies. **Allowable Values:**  Valid array of one or more reward policy objects |
| data\[].**token** string  Conditionally returned | Unique identifier of the reward policy. **Allowable Values:**  36 char max |
| data\[].**name** string  Conditionally returned | Name of the reward policy. **Allowable Values:**  255 char max |
| data\[].**description** string  Conditionally returned | Description of the reward policy. **Allowable Values:**  255 char max |
| data\[].**settlement\_strategy** string  Conditionally returned | Reward settlement strategy for a credit program. **Allowable Values:**  `STATEMENT`, `LIVE` |
| data\[].**accrual\_strategy** string  Conditionally returned | Reward accrual strategy for a credit program. If no value for `accrual_strategy` is set, the default value of this field is `DEFAULT`. **Allowable Values:**  `DEFAULT`, `PAYMENT` |
| data\[].**rounding\_strategy** string  Conditionally returned | Rounding strategy for reward accrual calculations. If no value for `rounding_strategy` is set, then the default value of this field is `ROUND_HALF_EVEN`. Available options: - `ROUND_UP`: Always rounds away from zero to whole numbers. - `ROUND_DOWN`: Always rounds towards zero to whole numbers. - `ROUND_HALF_EVEN`: Rounds to two decimal places using half-even logic (default). - `ROUND_HALF_EVEN_WHOLE`: Rounds to whole numbers using half-even logic. **Allowable Values:**  `ROUND_UP`, `ROUND_DOWN`, `ROUND_HALF_EVEN`, `ROUND_HALF_EVEN_WHOLE` |
| data\[].**rules** array of objects  Conditionally returned | A list of one or more reward rules. **Allowable Values:**  Valid array of one or more `rules` objects |
| data\[].rules\[].**description** string  Returned | The description of the rule. **Allowable Values:**  255 char max |
| data\[].rules\[].**type** string  Returned | Type of rule. **Allowable Values:**  `MULTIPLIER_PER_TRANSACTION` |
| data\[].rules\[].**calculation\_type** string  Conditionally returned | Type of calculation to use to evaluate if a rule has been satisfied. **Allowable Values:**  `PER_TRANSACTION` |
| data\[].rules\[].**multiplier** decimal  Conditionally returned | The reward multiplier to apply the transaction, where '1' means 1x transaction amount. **Allowable Values:**  Any integer |
| data\[].rules\[].**amount** decimal  Conditionally returned | The static amount to reward if the rule conditions are met. **Allowable Values:**  Any integer |
| data\[].rules\[].**attributes** object  Conditionally returned | Additional properties for which the rule can be used to determine reward accrual eligibility for a transaction. **Allowable Values:**  mcc: `1500`, `0001-1499` mid: `255` |
| data\[].rules\[].attributes.**mcc** array of strings  Conditionally returned | List of merchant category codes (MCCs). MCCs must be a four-digit number, or a range of two four-digit numbers separated by a hyphen. **Allowable Values:**  `1500`, `0001-1499` |
| data\[].rules\[].attributes.**mid** string  Conditionally returned | Merchant ID for the rule. **Allowable Values:**  "255" |
| data\[].rules\[].attributes.**min\_spend** decimal  Conditionally returned | Minimum spend amount. **Allowable Values:**  100 |
| data\[].rules\[].attributes.**max\_spend** decimal  Conditionally returned | Maximum spend amount. **Allowable Values:**  150 |
| data\[].rules\[].attributes.**spend\_total** decimal  Conditionally returned | Total spend amount. **Allowable Values:**  100 |
| data\[].rules\[].attributes.**spend\_days** integer  Conditionally returned | Maximum number of days since account creation within which the minimum spend requirements must be met to qualify for the reward (used for signup bonus rules). Positive integer values are allowed, with a minimum value of `1`. **Allowable Values:**  1 min |
| data\[].**conversions** array of objects  Conditionally returned | List of one or more reward conversions. **Allowable Values:**  Valid array of one or more `conversion` objects |
| data\[].conversions\[].**type** string  Returned | Type of conversion. **Allowable Values:**  `STATEMENT_CREDIT` |
| data\[].conversions\[].**conversion\_rate** decimal  Returned | The rate that points are worth with converting the REDEMPTION\_TYPE indicated. **Allowable Values:**  0.001 min  Format: 0.000 |
| data\[].conversions\[].**conversion\_increment** integer  Returned | The static amount to reward if the rule conditions are met. **Allowable Values:**  Any integer |
| data\[].conversions\[].**currency** string  Conditionally returned | Type of currency used with the conversion rate. **Allowable Values:**  Currency code, such as EUR or USD. |
| data\[].**exclusions** object  Conditionally returned | Defines what merchant category codes (MCCs) are excluded from earning rewards. MCCs must be a four-digit number, or a range of two four-digit numbers separated by a hyphen. **Allowable Values:**  `1500`, `0001-1499` |
| data\[].exclusions.**use\_default\_exclusions** boolean  Conditionally returned | Indicates whether to use the default exclusion list. - If `true`, the default exclusion list is used. - If `false`, the custom exclusion list is used, if custom exclusions are included. **Allowable Values:**  `true`, `false` |
| data\[].exclusions.**custom\_exclusions** array of strings  Conditionally returned | List of merchant category codes (MCCs). MCCs must be a four-digit number, or a range of two four-digit numbers separated by a hyphen. **Allowable Values:**  `1500`, `0001-1499` |
| data\[].**created\_time** datetime  Conditionally returned | Date and time when the reward policy was created on Marqeta's credit platform, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| data\[].**updated\_time** datetime  Conditionally returned | Date and time when the reward policy was last updated on Marqeta's credit platform, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |

## Sample response body

```json JSON expandable lines wrap theme={null}
{
  "count": 2,
  "start_index": 0,
  "end_index": 2,
  "is_more": true,
  "data": [
    {
      "token": "my_reward_policy_token_1234",
      "name": "Gold Reward Policy",
      "description": "A gold reward policy",
      "settlement_strategy": "STATEMENT",
      "accrual_strategy": "DEFAULT",
      "rounding_strategy": "ROUND_HALF_EVEN",
      "rules": [
        {
          "description": "Earn 3x on selected categories.",
          "type": "MULTIPLIER_PER_TRANSACTION",
          "calculation_type": "PER_TRANSACTION",
          "multiplier": 3,
          "amount": null,
          "attributes": {
            "mcc": [
              "0001-1499",
              "1500"
            ]
          }
        }
      ],
      "conversions": [
        {
          "type": "STATEMENT_CREDIT",
          "conversion_rate": 0.001,
          "conversion_increment": 10,
          "currency": "USD"
        }
      ],
      "exclusions": {
        "use_default_exclusions": false,
        "custom_exclusions": [
          "2000-2999",
          "4321"
        ]
      },
      "created_time": "2025-04-01T23:41:58.802Z",
      "updated_time": "2025-04-05T16:04:48.643Z"
    }
  ]
}
```


## Related topics

- [Reward Policies Overview](https://www.marqeta.com/docs/core-api/credit-policies/reward-policies.md)
- [Policies Overview](https://www.marqeta.com/docs/core-api/credit-policies.md)
- [Create reward policy](https://www.marqeta.com/docs/core-api/credit-policies/reward-policies/create-reward.md)
- [Update reward policy](https://www.marqeta.com/docs/core-api/credit-policies/reward-policies/update-reward.md)
- [Clone reward policy](https://www.marqeta.com/docs/core-api/credit-policies/reward-policies/clone-reward.md)