> ## 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.
# Reward Conversions Management
> Use the `/credit/rewards/conversions` endpoint to manage the reward conversion rates for reward redemptions.
export const EndpointCard = ({method = "API", title, children, href, arrow = true}) => {
const METHOD_STYLES = {
GET: {
bg: "mint-bg-green-400/20 dark:mint-bg-green-400/20",
text: "mint-text-green-700 dark:mint-text-green-400",
border: "mint-border-green-300 dark:mint-border-green-700"
},
POST: {
bg: "mint-bg-blue-400/20 dark:mint-bg-blue-400/20",
text: "mint-text-blue-700 dark:mint-text-blue-400"
},
PUT: {
bg: "mint-bg-yellow-400/20 dark:mint-bg-yellow-400/20",
text: "mint-text-yellow-700 dark:mint-text-yellow-400"
},
PATCH: {
bg: "mint-bg-orange-400/20 dark:mint-bg-orange-400/20",
text: "mint-text-orange-700 dark:mint-text-orange-400"
},
DELETE: {
bg: "mint-bg-red-400/20 dark:mint-bg-red-400/20",
text: "mint-text-red-700 dark:mint-text-red-400"
},
API: {
bg: "mint-bg-black",
text: "mint-text-white"
}
};
const MethodBadge = ({method}) => {
const style = METHOD_STYLES[method?.toUpperCase()] ?? METHOD_STYLES.GET;
return
{method?.toUpperCase()}
;
};
const content =
{}
{}
{title}
{children &&
{children}
}
Retrieve conversion entries
**Action:** `GET`\
**Endpoint:** `/credit/rewards/conversions`
Retrieve conversion entries by reward program short code.
Response body
| Fields | Description |
| ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| count
integer
Returned | Number of resources returned.
**Allowable Values:**
1–100 |
| 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
Conditionally returned | A value of `true` indicates that more unreturned resources exist.
**Allowable Values:**
`true`, `false` |
| data
array of objects
Returned | List of conversion objects.
**Allowable Values:**
Valid array of one or more conversion objects |
| data\[].**token**
string
Returned | Unique identifier of the conversion.
**Allowable Values:**
36 char max |
| data\[].**bundle\_token**
string
Returned | Unique identifier of the bundle.
**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\[].**conversion\_rate**
decimal
Returned | Rate that points are worth when converting them using the `REDEMPTION_TYPE` indicated.
**Allowable Values:**
0.001 min
Format: 0.000 |
| data\[].**conversion\_increment**
integer
Returned | Static amount to reward if rule conditions are met.
**Allowable Values:**
Any integer |
| data\[].**currency**
string
Conditionally returned | Type of currency used for the conversion rate. Three-digit ISO 4217 currency code.
**Allowable Values:**
Any currency code allowed by your program |
| data\[].**is\_active**
boolean
Returned | A value of `true` indicates that the conversion is active.
**Allowable Values:**
`true`, `false`
**Default value:**`true` |
| data\[].**created\_time**
datetime
Returned | Date and time when the conversion entry was created on the Marqeta platform, in UTC.
**Allowable Values:**
Format: yyyy-MM-ddThh:mm:ssZ |
| data\[].**updated\_time**
datetime
Returned | Date and time when the conversion entry was last updated on the Marqeta platform, in UTC.
**Allowable Values:**
Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
```json JSON lines wrap theme={null}
{
"count": 1,
"start_index": 0,
"end_index": 0,
"data": [
{
"token": "8a8cfd94-978a-4b03-80e0-ed57be0c6230",
"type": "STATEMENT_CREDIT",
"conversion_rate": 1.3,
"conversion_increment": 130,
"currency": "USD",
"is_active": true,
"bundle_token": "f0cf97cb-76f7-47a5-83e7-188b9e741cf9",
"created_time": "2024-01-04T20:37:11Z",
"updated_time": "2024-01-04T20:37:11Z"
}
]
}
```
## Related topics
- [Reward Rules Management](/docs/core-api/credit-reward-rules-management.md)
- [About Reward Accounts](/docs/developer-guides/about-credit-reward-accounts.md)
- [Account Rewards](/docs/core-api/credit-account-rewards.md)
- [Reward Redemptions](/docs/core-api/credit-reward-redemptions.md)
- [Credit Rewards](/docs/diva-api/credit-rewards.md)