> ## 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 redemptions > Retrieve an array of reward redemptions for a specific reward account. GET/credit/rewards/accounts/\{token}/redemptions Retrieve an array of reward redemptions 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 | | count integer Optional | Number of 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\_created 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 `createdTime`. Do not sort by field names that appear in response bodies, such as `created_time`. **Allowable Values:** `createdTime`, `-createdTime` | | type string Optional | Type of reward redemptions in the returned array. **Allowable Values:** `EXTERNAL`, `STATEMENT_CREDIT` | ## Response body | Fields | Description | | - | - | | data array of objects Conditionally returned | List containing one or more redemptions. **Allowable Values:** Valid array of one or more redemption objects | | data\[].**token** string Returned | Unique identifier of the reward redemption. **Allowable Values:** 36 char max | | data\[].**type** string 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` | | data\[].**destination** string Conditionally returned | Destination of the `EXTERNAL` redemption for the brand to track. **Allowable Values:** 255 char max | | data\[].**amount** decimal Returned | Amount to redeem. **Allowable Values:** Format: 0.00 | | data\[].**conversion\_rate** decimal Conditionally returned | Rate that points are worth when converting them using the `REDEMPTION_TYPE` indicated. **Allowable Values:** 0.001 min Format: 0.000 | | data\[].**currency** string Conditionally returned | Type of currency used for the conversion rate. Three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html). **Allowable Values:** Any currency code allowed by your program | | data\[].**note** string Conditionally returned | Note explaining why the reward is being redeemed. **Allowable Values:** 255 char max | | data\[].**sor\_reward\_token** string Conditionally returned | Unique identifier of the system of reward (SOR) reward that was created to represent the reward redemption as a `STATEMENT_CREDIT` on a credit account. The SOR entry is a positive amount that is added to the account balance. **Allowable Values:** 36 char max | | data\[].**external\_settlement\_date\_time** datetime Conditionally returned | Date and time when the reward redemption was settled on your external platform, in UTC. This field is returned if you handled the reward redemption outside of Marqeta's credit platform. **Allowable Values:** Format: yyyy-MM-ddThh:mm:ssZ | | data\[].**receiving\_account\_token** string Conditionally returned | Unique identifier of the external account receiving the reward redemption. This token is the [payment source](https://www.marqeta.com/docs/core-api/payment-sources/) token. **Allowable Values:** 36 char max | | data\[].**created\_time** datetime Returned | Date and time when the reward redemption was created on the Marqeta platform, in UTC. **Allowable Values:** Format: yyyy-MM-ddThh:mm:ssZ | | data\[].**updated\_time** datetime Conditionally returned | Date and time when the reward redemption was updated on the Marqeta platform, in UTC. **Allowable Values:** Format: yyyy-MM-ddThh:mm:ssZ | | count integer Conditionally returned | Number of resources returned. **Allowable Values:** 1–100 | | start\_index integer Conditionally returned | Sort order index of the first resource in the returned array. **Allowable Values:** Any integer | | end\_index integer Conditionally returned | Sort order index of the last resource in the returned array. **Allowable Values:** Any integer | | is\_more boolean Conditionally returned | A value of `true` indicates that more unreturned resources exist. **Allowable Values:** `true`, `false` | ## Sample response body ```json JSON expandable lines wrap theme={null} { "count": 1, "start_index": 0, "end_index": 0, "is_more": false, "data": [ { "token": "c21b04ad-37de-4433-890a-3cece8adefc7", "type": "EXTERNAL", "amount": 10000, "conversion_rate": 1.5, "currency": "USD", "destination": "BRAND_WALLET", "note": "Redeeming reward balance to Brand Wallet at brand conversion rate 1.5 cents per point.", "created_time": "2024-01-01T20:37:11Z" }, { "token": "132fb632-1197-4d01-9eca-bee3ac2e7502", "type": "STATEMENT_CREDIT", "amount": 5000, "conversion_rate": 0.01, "note": "Redeeming reward balance to Statement Credit 1 cent for every 1 point", "created_time": "2024-01-02T20:37:11Z" }, { "token": "7d34d209-e350-4bca-a678-29b9fbfe45d5", "type": "EXTERNAL", "amount": 900, "conversion_rate": 1.3, "destination": "MILEAGE_PLUS", "note": "Redeeming reward balance to MILEAGE_PLUS Program at a conversion rate of 1.3 miles per point", "receiving_account_token": "c21b04ad-37de-4433-890a-3cece8adefc7", "created_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 balance](https://www.marqeta.com/docs/core-api/credit-reward-redemptions/retrieve-balance.md) - [Create reward redemption](https://www.marqeta.com/docs/core-api/credit-reward-redemptions/create-reward-redemption.md) - [Retrieve reward redemption](https://www.marqeta.com/docs/core-api/credit-reward-redemptions/retrieve-reward-redemption.md) - [List reward entries for a reward account](https://www.marqeta.com/docs/core-api/credit-reward-accounts/reward-entries/list-entries.md)