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

# List Notification Topics

`GET /notifications/topics`

Lists the platform's visible notification topics — the categories users can set notification preferences on. App-created topics are internal and not returned.

## Query parameters

- `topic_type` 'user' | 'account_team'
- `first` integer
- `after` string

## Response `200`

notification topics listed

- object
  - `data` NotificationTopic[], required
    - `default_preference_value` boolean, required — Whether notifications for this topic are enabled by default when the user has not set a preference.
    - `description` string, nullable, required — Human-readable explanation of what notifications in this topic are about. `null` when no description has been set.
    - `id` string, required — Notification topic ID, prefixed `topic_`. This is the value the notification preference endpoints take as `topic_id`.
    - `identifier` string, required — Stable, human-readable name for the category, such as `new-follower`. Unlike `id`, it is the same in every environment, which makes it the value to match on in code and to read in logs. Treat it as an opaque string: the set is open and the casing is historical rather than normalized.
    - `is_mention` boolean, required — Whether this topic exclusively handles mention-based notifications.
    - `name` string, required — Display name shown in notification preference settings.
    - `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

---

[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/db0883548bc5/schema)