Skip to main content
GET
/
b2b
/
notification-settings
Get notification settings
curl --request GET \
  --url https://{host}/b2b/notification-settings \
  --header 'Authorization: Bearer <token>' \
  --header 'x-user-id: <x-user-id>'
{
  "app": [
    {
      "category": "Activity",
      "notifications": [
        {
          "id": "app_transactional",
          "name": "Transaction Notifications",
          "description": "Receive notifications about deposits, withdrawals, and order settlements",
          "active": true
        }
      ]
    },
    {
      "category": "Market Insights",
      "notifications": [
        {
          "id": "app_learning_guide",
          "name": "Learning Guides",
          "description": "Get notified when new educational content is published",
          "active": true
        },
        {
          "id": "app_analyst_insight",
          "name": "Analyst Insights",
          "description": "Receive insights from our investment analysts",
          "active": false
        },
        {
          "id": "app_quick_take",
          "name": "Quick Takes",
          "description": "Get brief market updates and quick insights",
          "active": true
        },
        {
          "id": "app_daily_recap",
          "name": "Daily Market Recap",
          "description": "Daily summary of market movements and your portfolio",
          "active": true
        },
        {
          "id": "app_weekly_review",
          "name": "Weekly Review",
          "description": "Weekly summary of your portfolio performance",
          "active": false
        }
      ]
    },
    {
      "category": "Promotional",
      "notifications": [
        {
          "id": "app_promotional",
          "name": "Promotional Notifications",
          "description": "Receive updates about new features and special offers",
          "active": false
        }
      ]
    }
  ],
  "email": [
    {
      "category": "Activity",
      "notifications": [
        {
          "id": "email_transactional",
          "name": "Transaction Emails",
          "description": "Receive email notifications about account activity",
          "active": true
        }
      ]
    },
    {
      "category": "Newsletters",
      "notifications": [
        {
          "id": "email_wealthybites",
          "name": "WealthyBites Newsletter",
          "description": "Weekly newsletter with investment insights and market updates",
          "active": true
        }
      ]
    },
    {
      "category": "Promotional",
      "notifications": [
        {
          "id": "email_promotional",
          "name": "Promotional Emails",
          "description": "Receive emails about new features and special offers",
          "active": false
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Auth0-issued access token that includes the scopes listed for the endpoint.

Headers

​
x-user-id
string
required

MongoDB identifier of the user whose notification settings are being accessed or modified.

Example:

"507f1f77bcf86cd799439011"

Response

Notification settings retrieved successfully

Complete notification settings for a user, organized by notification type (app/email) and category. Both app and email are optional in the schema for flexibility, but in practice they will always be present since notification settings are created during user creation.

​
app
object[]

Array of app notification categories

​
email
object[]

Array of email notification categories