Sign in
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"
    }
  ]
}

Changes

Changed in 3 of the 74 revisions of this API.4

  • f1020c3ecda42See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • bdd0e2c70d581See the full diff
    • ○

      the security scope user:notifications:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    This revision also has 16 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 099fdc3be4221See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.