> ## 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.

# Retrieve reward redemption balance

> Retrieve redemption amounts for a specified date range by redemption type.

GET/credit/rewards/accounts/\{token}/redemptions/balance

Retrieve redemption amounts for a specified date range by redemption type.

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | Unique identifier of the reward account. **Allowable Values:**  Existing reward account token |

## URL query parameters

| Fields | Description |
| - | - |
| start\_date datetime  Optional | Starting date and time of a date range from which to return resources, in UTC. **Allowable Values:**  format: yyyy-MM-ddThh:mm:ssZ |
| end\_date datetime  Optional | Ending date and time of a date range from which to return resources, in UTC. **Allowable Values:**  format: yyyy-MM-ddThh:mm:ssZ |

## Response body

| Fields | Description |
| - | - |
| start\_date datetime  Conditionally returned | Starting date and time of a date range from which to return the redemption balance, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| end\_date datetime  Conditionally returned | Ending date and time of a date range from which to return the redemption balance, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| redemptions array of objects  Conditionally returned | List of each redemption total by type. **Allowable Values:**  Valid array of one or more redemption objects |
| redemptions\[].**type** string  Conditionally returned | Type of redemption. - `EXTERNAL` - You issue the redemption on your external platform; Marqeta adjusts the reward account balance on the system of record. - `STATEMENT_CREDIT` - Marqeta issues the redemption as a statement credit on the associated account. **NOTE**: This creates a new journal entry on the account and cannot be undone. **Allowable Values:**  `EXTERNAL`, `STATEMENT_CREDIT` |
| redemptions\[].**destination** string  Conditionally returned | The brand-managed program to which the reward balance was redeemed. **Allowable Values:**  255 char max |
| redemptions\[].**point\_redeemed** decimal  Conditionally returned | Total points redeemed for redemption type for a reward account. **Allowable Values:**  Any integer |

## Sample response body

```json JSON expandable lines wrap theme={null}
{
  "start_date": "2023-01-05T20:37:11Z",
  "end_date": "2024-01-05T20:37:11Z",
  "redemptions": [
    {
      "type": "EXTERNAL",
      "destination": "BRAND_WALLET",
      "points_redeemed": 100000
    },
    {
      "type": "EXTERNAL",
      "destination": "MILEAGE_PLUS",
      "points_redeemed": 5000
    },
    {
      "type": "STATEMENT_CREDIT",
      "points_redeemed": 5000
    }
  ],
  "retrieved_time": "2024-01-05T20:37:11Z"
}
```


## Related topics

- [Reward Redemptions Overview](https://www.marqeta.com/docs/core-api/credit-reward-redemptions.md)
- [Retrieve reward redemption](https://www.marqeta.com/docs/core-api/credit-reward-redemptions/retrieve-reward-redemption.md)
- [Retrieve reward account balances](https://www.marqeta.com/docs/core-api/credit-reward-accounts/retrieve-balances.md)
- [Create reward redemption](https://www.marqeta.com/docs/core-api/credit-reward-redemptions/create-reward-redemption.md)
- [List reward redemptions](https://www.marqeta.com/docs/core-api/credit-reward-redemptions/list-reward-redemptions.md)