Get Support Notifications

The GET /netevia/support/notifications endpoint retrieves a filtered list of special notifications from the Netevia banking platform. Callers can narrow results by date range, severity level, group category, or a free-text search term. Pagination is supported via skip and take parameters.

Endpoint

GET /netevia/support/notifications

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 surface platform-level alerts, messages, campaigns, or cardholder agreement notices that are relevant to your integration. It is useful for support dashboards that need to display current warnings or informational notices scoped to specific user roles or time windows. Partners can poll this endpoint to detect new notifications and push them downstream to end users.

Query Parameters

Response

200 OK

Returns an array of notification objects matching the applied filters.

[
  {
    "id": 1042,
    "createdDate": "2026-05-15T09:00:00Z",
    "updatedDate": "2026-05-16T14:30:00Z",
    "subject": "Scheduled Maintenance Window",
    "body": "The Netevia banking platform will undergo scheduled maintenance on May 20, 2026 from 02:00–04:00 UTC. ACH transfers initiated during this window may experience delays.",
    "group": "Notifications",
    "level": "Warning",
    "publicationTime": "2026-05-15T10:00:00Z",
    "htmlLink": "https://status.netevia.com/notices/1042",
    "roles": ["MainUser", "SubUser"],
    "userIds": null
  },
  {
    "id": 1043,
    "createdDate": "2026-06-01T08:00:00Z",
    "updatedDate": null,
    "subject": "Cashback Rewards Campaign — June 2026",
    "body": "Earn 2x rewards on all card purchases made in June 2026. Rewards are automatically applied to your financial account at month end.",
    "group": "Campaigns",
    "level": "Info",
    "publicationTime": "2026-06-01T08:00:00Z",
    "htmlLink": null,
    "roles": ["Consumer", "MainUser"],
    "userIds": null
  }
]

Error Codes

Common Mistakes

• Passing a date string in a format other than ISO 8601 (e.g., MM/DD/YYYY) for fromDate or toDate — use 2026-06-01T00:00:00Z format.
• Providing an unrecognized value for the level or group enum parameters — only the documented values are accepted.
• Omitting pagination parameters on large datasets — always pass skip and take to avoid unexpectedly large responses.
• Expecting the level field to have more than two values — only Info and Warning are valid.

Related Endpoints

• GET /netevia/support/notifications/{id} — Retrieve a single notification by its unique ID.
• POST /api/auth/v2 — Obtain a Bearer token for authentication.
• POST /api/auth/refresh — Refresh an expiring Bearer token.

Example

curl -X GET "https://api.banking.netevia.dev/netevia/support/notifications?fromDate=2026-05-01T00%3A00%3A00Z&toDate=2026-06-08T23%3A59%3A59Z&level=Warning&group=Notifications&skip=0&take=50" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"