---
title: "List Notifications"
method: GET
path: "/notifications"
tags: ["Notifications"]
---

# List Notifications

`GET /notifications`

Lists the authenticated user's notifications, newest first. Requires a user credential — an account API key has no notification feed. Without filters the feed spans every experience the user belongs to plus the teams they are a member of.

## Query parameters

- `unread` boolean
- `experience_id` string
- `account_id` string
- `mentions` boolean
- `first` integer
- `after` string

## Response `200`

notifications listed

- object
  - `data` Notification[], required
    - `account` NotificationAccount, required
      - `id` string, required — Account ID, prefixed `biz_`.
      - `logo_url` string, nullable, required — Account logo image URL. `null` when the account has not uploaded one.
      - `route` string, nullable, required — URL slug of the account's store page on whop.com.
      - `title` string, required — Account display name.
    - `attachment_url` string, required — Image displayed alongside the notification — the sender's avatar, or the default notification image.
    - `content` string, required — The body text of the notification displayed to the user.
    - `created_at` string, required — When the notification was created, as an ISO 8601 timestamp.
    - `experience` NotificationExperience, required
      - `app` NotificationExperienceApp, required
        - `icon_url` string, required — Icon image URL. Always present — the default app icon when none is uploaded.
        - `id` string, required — App ID, prefixed `app_`.
      - `id` string, required — Experience ID, prefixed `exp_`.
      - `name` string, nullable, required — Display name of the experience.
    - `id` string, required — Notification ID. Feed rows carry a composite id that doubles as the list cursor.
    - `iframe_link` string, nullable, required — The same destination on the app's own domain, which the Whop web and mobile clients embed instead of navigating to it. Only relevant if you render Whop apps yourself. `null` when the notification carries its own `link`.
    - `link` string, nullable, required — The whop.com page the notification opens, as a normal top-level navigation. This is the link to use unless you host Whop apps yourself. `null` when the notification has no click-through destination.
    - `mentions_me` boolean, required — Whether the authenticated user was directly mentioned in this notification.
    - `rest_path` string, nullable, required — Additional path information appended to the notification's deep link, if any.
    - `sender` NotificationSender, required
      - `id` string, required — User ID, prefixed `user_`.
      - `name` string, nullable, required — Display name.
      - `username` string, required — Public username.
    - `subject` string, required — The title line of the notification displayed to the user.
    - `topic` NotificationTopicSummary, required
      - `default_preference_value` boolean, required — Whether notifications for this topic are enabled by default when the user has not set a preference.
      - `id` string, required — Notification topic ID, prefixed `topic_`.
      - `is_mention` boolean, required — Whether this topic exclusively handles mention-based notifications.
      - `topic_type` 'account' | 'user' | 'account_team', required — Scope of the topic: whether it applies to an account, a user, or an account's team.
  - `page_info` object, required
    - `end_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/866821546d67/schema)