> ## 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 account balances

> Retrieve rewards balances for a specific reward account.

GET/credit/rewards/accounts/\{token}/balances

Retrieve rewards balances for a specific reward account.

## 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 |
| - | - |
| billing\_cycle\_opening\_date datetime  Returned | Opening date of the billing cycle for which rewards were accrued, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| billing\_cycle\_closing\_date datetime  Returned | Closing date of the billing cycle for which rewards were accrued, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| total\_spend\_this\_cycle decimal  Returned | Total amount spent during a given billing cycle, minus any refunds or disputes, even if transactions did not result in a reward. Used to determine reward accrual. **Allowable Values:**  Format: 0.00 |
| points\_balance object  Returned | Pending and total accrual balance (in points) for the reward account. **Allowable Values:**  `accrued_this_cycle`, `total_reward_balance` |
| points\_balance.**accrued\_this\_cycle** decimal  Returned | Pending balance (in points) for a reward account. **Allowable Values:**  Any integer |
| points\_balance.**total\_reward\_balance** decimal  Returned | Total reward balance (in points) for a reward account. **Allowable Values:**  Any integer |
| reward\_values array of objects  Returned | List of possible reward conversion values. **Allowable Values:**  Valid array of one or more `reward_values` objects |
| reward\_values\[].**redemption\_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` |
| reward\_values\[].**conversion\_rate** decimal  Returned | Conversion rate of the reward account's points, if they were used for this redemption type. **Allowable Values:**  0.001 min  Format: 0.000 |
| reward\_values\[].**conversion\_increment** decimal  Returned | Allowed point increments that the reward account must have to use this redemption type. **Allowable Values:**  Any integer |
| retrieved\_time datetime  Conditionally returned | Retrieval date of the reward account's accrual balance, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |

## Sample response body

```json JSON lines wrap theme={null}
{
  "billing_cycle_opening_date": "2023-12-25T20:37:11Z",
  "billing_cycle_closing_date": "2024-01-24T20:37:11Z",
  "total_spend_this_cycle": 5832,
  "points_balance": {
    "accrued_this_cycle": 10000,
    "total_reward_balance": 25000
  },
  "reward_values": [
    {
      "redemption_type": "STATEMENT_CREDIT",
      "conversion_rate": 0.001,
      "conversion_increment": 10
    }
  ],
  "retrieved_time": "2024-01-05T20:37:11Z"
}
```


## Related topics

- [About Reward Accounts](https://www.marqeta.com/docs/developer-guides/about-credit-reward-accounts.md)
- [Reward Accounts Overview](https://www.marqeta.com/docs/core-api/credit-reward-accounts.md)
- [Retrieve reward redemption balance](https://www.marqeta.com/docs/core-api/credit-reward-redemptions/retrieve-balance.md)
- [Retrieve reward account](https://www.marqeta.com/docs/core-api/credit-reward-accounts/retrieve-reward-account.md)
- [Retrieve reward account accruals](https://www.marqeta.com/docs/core-api/credit-reward-accounts/retrieve-accruals.md)