Convert a reward points balance into its equivalent USD dollar amount.
Get User Rewards in Currency
This endpoint converts a specified number of reward points into their equivalent USD value in real time. It allows customers to understand the exact monetary amount they would receive if they chose to redeem their accumulated reward points as cash. This is useful for informed decision-making before initiating a rewards redemption.
Endpoint
GET /api/UsersReward/v2/amountInDollar
Authentication
Bearer token required. Obtain via:
POST https://api.banking.netevia.dev/api/auth/v2Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.
When to use
Use this endpoint when a business customer wants to check the cash value of their reward points before redeeming them. It is typically called prior to a rewards-to-cash redemption flow to display the expected payout amount. It can also be used in dashboards or summary screens to show customers the current monetary worth of their points balance.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| points | integer (int64) | No | The number of reward points to convert into a USD dollar amount. |
Response
200 OK
| Field | Type | Description |
|---|---|---|
| value | integer (int64) | The equivalent USD amount (in cents or whole dollars) corresponding to the provided reward points. |
{
"value": 2500
}Error Codes
| Code | When it happens |
|---|---|
| 400 | The points parameter is malformed or contains a non-integer value. |
| 401 | Token missing, expired, or invalid. |
| 403 | Insufficient permissions to access rewards data. |
| 404 | No rewards conversion rate found for the given points value. |
| 500 | Internal server error. |
Common Mistakes
- Omitting the
pointsquery parameter will result in a response with a zero or null value rather than an error — always pass a valid points integer. - Reward points are only available for business customers; calling this endpoint with a personal customer token may return 0 or a permissions error.
- The returned
valuefield represents the converted amount as an integer — confirm with your account manager whether the value is expressed in cents or whole dollars for your integration.
Related Endpoints
GET /api/UsersReward/v2/balance— Retrieve the current reward points balance for the authenticated customer.POST /api/UsersReward/v2/redeem— Redeem reward points as a cash transfer to a financial account.GET /api/UsersReward/v2/history— View the transaction history of earned and redeemed reward points.
Example
curl -X GET "https://api.banking.netevia.dev/api/UsersReward/v2/amountInDollar?points=2500" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"