Self-service subscriptions
Let your users subscribe to alerts and manage the assets they follow.
Overview
Beta
Self-service subscriptions are being rolled out. Contact your account manager to enable them.
The self-service widget lets your end users subscribe to personalized alerts and choose the assets they follow, inside your app, without a custom integration. The widget calls the endpoints below; you can also call them from your backend.
- Each user has one watchlist.
- Changes are applied asynchronously, within about 1 hour.
- Authentication uses a Bridgewise token obtained through single sign-on with your identity provider.
PUT /portfolio-analysis/subscription
DELETE /portfolio-analysis/subscription
GET /portfolio-analysis/portfoliosSubscribe
Subscribes the user and sets their watchlist. The body is the full watchlist: it replaces the previous one. Calling it twice with the same body has the same effect as calling it once.
Query parameters
tenant_idstringRequireduser_idstringRequiredBody
collection_iduuidpreferred_languagesarray of stringsRequired["en-US"]. Format xx-XX.assetsarrayRequiredassets[].tickerstringAAPL.assets[].exchangestringXNAS.assets[].asset_typeenumstock, fund or bond. ETFs are fund.assets[].currencystringUSD.Returns
202 Accepted, with state: "pending_sync" and the expected sync time.
curl -X PUT "https://rest.bridgewise.com/portfolio-analysis/subscription?tenant_id=<tenant>&user_id=user-42" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"collection_id": "8f3c2a1e-5b47-4c1d-9e6a-2f0b7d4c9a31",
"preferred_languages": ["en-US"],
"assets": [
{ "ticker": "AAPL", "exchange": "XNAS", "asset_type": "stock", "currency": "USD" }
]
}'{
"tenant_id": "<tenant>",
"user_id": "user-42",
"subscribed": true,
"state": "pending_sync",
"watchlist_id": "8f3c2a1e-5b47-4c1d-9e6a-2f0b7d4c9a31",
"sync_eta_seconds": 3600,
"requested_at": "2026-11-16T12:00:00Z"
}Unsubscribe
Stops alerts for the user. The watchlist is kept, so the user can subscribe again later.
Query parameters
tenant_idstringRequireduser_idstringRequiredcollection_iduuidRequiredReturns
202 Accepted. If the user is already unsubscribed, 200 or 204.
curl -X DELETE "https://rest.bridgewise.com/portfolio-analysis/subscription?tenant_id=<tenant>&user_id=user-42&collection_id=8f3c2a1e-5b47-4c1d-9e6a-2f0b7d4c9a31" \
-H "Authorization: Bearer <token>"{
"subscribed": false,
"state": "pending",
"alert_delivery_stops_within_seconds": 3600
}Get a user's watchlist
Returns the user's collections. A collection with collection_type: "watchlist" means the user is subscribed. An empty list means the user is not subscribed.
Query parameters
tenant_idstringRequireduser_idstringRequiredcurl -G https://rest.bridgewise.com/portfolio-analysis/portfolios \
-H "Authorization: Bearer <token>" \
-d tenant_id=<tenant> \
-d user_id=user-42