Notifications

List Notification Badges

Changed on

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

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/notifications/badges
  • Auth: HTTP bearer

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

  • f1020c3ecda4Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • bdd0e2c70d58Revision changes
    • info

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