Get User Rewards in Currency
Deprecated: This endpoint is marked as deprecated. Use the current rewards conversion endpoint if available, or contact Netevia support for the recommended replacement.
This endpoint converts a specified number of reward points into their equivalent monetary value in USD. It enables business customers to understand the cash value of their accumulated rewards before deciding to redeem them. The conversion is performed in real time, providing an accurate dollar amount for the given points input.
Endpoint
GET /api/UsersReward/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 know the monetary equivalent of a specific number of reward points before initiating a redemption. It is particularly useful for building redemption preview flows in your application, allowing customers to make informed decisions about converting their rewards into cash.
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
Returns a single integer (int64) representing the equivalent USD amount in cents or whole dollars corresponding to the provided points value.
| Field | Type | Description |
|---|---|---|
| (root value) | integer (int64) | The USD equivalent of the supplied reward points balance. |
2500Error Codes
| Code | When it happens |
|---|---|
| 400 | The points parameter value is malformed or out of range |
| 401 | Token missing, expired, or invalid |
| 403 | Insufficient permissions to access rewards data |
| 404 | No rewards record found for the authenticated customer |
| 500 | Internal server error |
Common Mistakes
- Passing a negative value for
points— only non-negative integers are valid. - Omitting the
pointsquery parameter entirely — the API may return zero or an error rather than the customer's full balance conversion; always supply an explicit value. - Using this deprecated endpoint in new integrations — check for a current replacement endpoint before building new features.
Related Endpoints
GET /api/UsersReward— Retrieve the full rewards summary for the authenticated customerPOST /api/UsersReward/redeem— Redeem reward points as a transfer to a financial account
Example
curl -X GET "https://api.banking.netevia.dev/api/UsersReward/amountInDollar?points=5000" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"