Get User Rewards Activity

Returns a summary of rewards points earned and redeemed for the authenticated business customer, broken down by date range. The response includes a list of period-specific reports as well as an overall total. This endpoint is available to business customers only, as rewards are a business-exclusive feature on the Netevia platform.

Endpoint

GET /api/UsersReward/Activity

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 when you need to display a business customer's rewards history on a dashboard or statement. It is useful for building reward summaries across configurable time windows such as the last 7 days, last month, or year-to-date. Call it when a user navigates to a rewards activity screen or when generating periodic rewards reports.

Query Parameters

Response

200 OK

Top-level fields:

Each object in data and the total object (rewardspointsdatereport):

{
  "data": [
    {
      "dateFrom": "2026-01-01",
      "dateTo": "2026-01-31",
      "pointsIn": 1200,
      "pointsOut": 300
    },
    {
      "dateFrom": "2026-02-01",
      "dateTo": "2026-02-28",
      "pointsIn": 850,
      "pointsOut": 0
    }
  ],
  "total": {
    "dateFrom": "2026-01-01",
    "dateTo": "2026-02-28",
    "pointsIn": 2050,
    "pointsOut": 300
  }
}

Error Codes

Common Mistakes

• Omitting the rewardActivity query parameter returns all available activity (equivalent to None); always pass an explicit period value when building time-scoped reports.
• Passing an unrecognized period string (e.g., "M3") results in a 400 error — use only the documented enum values: None, D7, M1, M6, Y1, QTD, YTD.
• This endpoint is for business customers only. Calling it with a personal customer token will return a 403 error.
• pointsOut represents points that left the account (redemptions or transfers); a value of 0 means no redemption occurred in that period, not that the field is absent.

Related Endpoints

• GET /api/UsersReward/Balance — Retrieve the current rewards points balance for the authenticated business customer
• POST /api/UsersReward/Redeem — Redeem rewards points by transferring them to a financial account or another business customer
• GET /api/UsersReward/Transactions — List individual rewards transactions for the authenticated business customer

Example

curl -X GET "https://api.banking.netevia.dev/api/UsersReward/Activity?rewardActivity=M6" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"