latestOpenAPI 3.1.02026-08-163864115.7 MB
c363cb2feb95
Notifications
List Notification Badges
Lists the authenticated user's per-experience unread badge state. Requires a user credential. Returns one row per experience the user belongs to (or per requested experience).
get/notifications/badges
Query parameters
experience_idsstring[]
Only return badges for these experiences (exp_ tags).
[ "exp_xxxxxxxxxxxxxx" ]
last_fetched_atstring
The client's last fetched-at ISO 8601 timestamp, used to partially refresh badges after a websocket message.
Response
badges listed
Example response
{
"data": [
{
"account_id": "biz_xxxxxxxxxxxxxx",
"experience_id": "exp_xxxxxxxxxxxxxx",
"last_viewed_at": "2026-01-01T12:00:00.000Z"
}
]
}