Get Rewards History for User

This endpoint retrieves the full reward accrual history for the authenticated business customer. Results can be filtered by date range and one or more reward types, covering all 14 reward activity categories including spending rewards, welcome bonuses, point exchanges, transfers, and gift card purchases. The response also includes the customer's current total point balance and any published reward reports.

Endpoint

GET /api/UsersReward/v2/history

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint to display a customer's reward activity feed, reconcile earned and spent points, or generate reward statements within a partner application. It is suited for business customers who need a full audit trail of point activity including cash exchanges and inter-account transfers.

Query Parameters

Reward Type Values

Response

200 OK

Top-level Response Object (rewardhistoryresponse)

Reward History Entry Fields (rewardpointsresponse)

Extended Transfer Fields (rewardpointsresponseextension — extends rewardpointsresponse)

{
  "totalPoints": 14250,
  "publishedReports": [
    {
      "item1": "2025-05-31T23:59:59Z",
      "item2": 500
    }
  ],
  "histories": [
    {
      "createdDate": "2025-06-01T10:22:00Z",
      "points": 120,
      "dateTransactions": "2025-06-01T10:20:00Z",
      "type": 1,
      "subjectId": "txn_abc123",
      "period": "2025-06-01T00:00:00Z",
      "amount": 4000,
      "typeName": "Spending Rewards",
      "subjectName": "Purchase at Merchant XYZ",
      "publishDate": "2025-06-02T00:00:00Z"
    },
    {
      "createdDate": "2025-05-28T14:05:00Z",
      "points": -500,
      "dateTransactions": "2025-05-28T14:03:00Z",
      "type": 12,
      "subjectId": "txn_def456",
      "period": "2025-05-01T00:00:00Z",
      "amount": 0,
      "typeName": "Transfer Out",
      "subjectName": "Transfer to Partner Account",
      "publishDate": "2025-05-28T00:00:00Z",
      "userId": 789012,
      "transferId": "xfer_ghi789"
    }
  ]
}

Error Codes

Common Mistakes

• Omitting dateFrom or dateTo — both query parameters are required; the request will fail with 400 if either is absent.
• Providing dateFrom in a format other than ISO 8601 date-time (e.g., 2025-06-01 instead of 2025-06-01T00:00:00Z) — use the full date-time format including time and timezone offset.
• Passing an invalid integer for types — only values 1 through 14 are valid; any other value will be rejected or silently ignored.
• Calling this endpoint for personal customers — rewards are a business customer feature only; the call will return 403.
• Expecting negative points for spending events — points are represented as positive for earned and negative for spent/transferred; check the type field to distinguish direction.

Related Endpoints

• GET /api/UsersReward/v2 — Retrieve current reward point balance for the authenticated user
• POST /api/UsersReward/v2/exchange — Exchange reward points for cash to a financial account
• POST /api/UsersReward/v2/transfer — Transfer reward points to another business customer's account
• POST /api/UsersReward/v2/giftcard — Redeem reward points for a gift card

Example

curl -X GET "https://api.banking.netevia.dev/api/UsersReward/v2/history?dateFrom=2025-05-01T00%3A00%3A00Z&dateTo=2025-06-01T23%3A59%3A59Z&types=1&types=11&types=12&types=13" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"