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

# List notifications

`GET /api/notifications`

List notifications for the user

## Query parameters

- `p` integer
- `readStatus` 'all' | 'unread'
- `repoType` 'dataset' | 'model' | 'space' | 'bucket' | 'kernel'
- `repoName` string
- `postAuthor` string
- `paperId` string
- `articleId` string
- `mention` 'all' | 'participating' | 'mentions'
- `lastUpdate` string, date-time

## Response `200`

The notifications for the user

- object
  - `notifications` union[], required
    - union
      - object
        - `type` 'paper', required
        - `updatedAt` string, date-time, required
        - `read` boolean, required
        - `discussionEventId` string
        - `paper` object, required
          - `_id` string, required
          - `title` string, required
        - `paperDiscussion` object, required
          - `id` string, required
          - `participating` object[], required
            - `_id` string, required
            - `avatar` string, required
            - `user` string, required
          - `paperId` string, required
      - object
        - `type` 'repo', required
        - `updatedAt` string, date-time, required
        - `read` boolean, required
        - `discussionEventId` string
        - `repo` RepoId, required
          - `name` string, required
          - `type` 'dataset' | 'model' | 'space' | 'bucket' | 'kernel', required
        - `discussion` object, required
          - `num` number, required
          - `title` string, required
          - `status` 'draft' | 'open' | 'closed' | 'merged', required
          - `id` string, required
          - `isPullRequest` boolean, required
          - `participating` object[], required
            - `_id` string, required
            - `avatar` string, required
            - `user` string, required
      - object
        - `type` 'post', required
        - `updatedAt` string, date-time, required
        - `read` boolean, required
        - `discussionEventId` string
        - `post` object, required
          - `id` string, required
          - `slug` string, required
          - `authorName` string, required
          - `title` string, required
          - `participating` object[], required
            - `_id` string, required
            - `avatar` string, required
            - `user` string, required
      - object
        - `type` 'community_blog', required
        - `updatedAt` string, date-time, required
        - `read` boolean, required
        - `discussionEventId` string
        - `blog` object, required
          - `id` string, required
          - `slug` string, required
          - `title` string, required
          - `canonical` boolean, required
          - `authorName` string
          - `participating` object[], required
            - `_id` string, required
            - `avatar` string, required
            - `user` string, required
  - `count` object, required
    - `view` number, required
    - `unread` number, required
    - `all` number, required
  - `start` number, required

---

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