List notifications
List a company's notifications, newest first, paginated. Notifications are what the app shows in its bell menu: bank connection failures, subscription…
Authentication
Authorization<token>A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.
companyId*stringuuidrecipientUserId?stringtypes?stringComma-separated notification types to return, e.g. "bankConnectionError,subscriptionChange". Omit to return all types.
eventType?stringFor subscriptionChange notifications, return only this MRR event type: new, upgrade, downgrade, cancel, or reactivate.
createdAfter?stringReturn notifications created on or after this date (YYYY-MM-DD).
^\d{4}-\d{2}-\d{2}$createdBefore?stringReturn notifications created on or before this date (YYYY-MM-DD).
^\d{4}-\d{2}-\d{2}$limit?stringoffset?stringPaginated list of notifications
application/json- response
items*array<>totalCount*numberentities*Avatar sidecar for the rows on this page. Notification rows carry ids, not counterparty data, so join against this map client-side rather than fetching each customer.
earliestCreatedTime*|Date of the earliest notification (YYYY-MM-DD) for this company and recipient, ignoring the active filter; null if there are none. Used to anchor a date picker.
curl -X GET 'https://api.saasflow.com/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/notifications'{ "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda", "type": "string", "recipientUserId": "string", "readTime": "2019-08-24T14:15:22Z", "payload": { "property1": null, "property2": null }, "createdTime": "2019-08-24T14:15:22Z", "createdUserId": "string", "lastUpdatedTime": "2019-08-24T14:15:22Z", "lastUpdatedUserId": "string" } ], "totalCount": 0, "entities": { "customers": { "property1": { "name": "string", "domains": [ "string" ], "logoUrl": "string" }, "property2": { "name": "string", "domains": [ "string" ], "logoUrl": "string" } } }, "earliestCreatedTime": "string"}