Get notification settings

Get Notification Settings

This endpoint returns the notification settings associated with the authenticated user or partner account. Use it to inspect which notification channels and event types are currently enabled. This is typically used before updating settings to understand the existing configuration.

Endpoint

GET /settings/informing

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 read the current notification preferences for an account, such as whether email, SMS, or webhook notifications are active for specific banking events. It is useful for building notification management UIs or verifying settings before making updates.

Response

200 OK

Returns the notification settings object for the authenticated account.

{
  "notificationsEnabled": true,
  "channels": {
    "email": true,
    "sms": false,
    "webhook": true
  },
  "events": {
    "transactionCreated": true,
    "transactionFailed": true,
    "accountStatusChanged": true,
    "cardIssued": false,
    "transferCompleted": true
  }
}

Error Codes

Common Mistakes

• Calling this endpoint without a valid Bearer token will result in a 401 error; ensure the token is obtained and refreshed before the 10-minute expiry.
• Expecting notification settings to exist for a newly created account before any settings have been configured may return a 404; initialize settings first if needed.

Related Endpoints

• PUT /settings/informing — Update notification settings for the authenticated account
• POST https://api.banking.netevia.dev/api/auth/v2 — Obtain Bearer token for authentication
• POST /api/auth/refresh — Refresh an existing Bearer token

Example

curl -X GET https://api.banking.netevia.dev/settings/informing \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"