---
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' | 'container'
- `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 — A hex string of 24 characters representing an ObjectId.
          - `title` string, required
        - `paperDiscussion` object, required
          - `id` string, required
          - `participating` object[], required
            - `_id` string, required — A hex string of 24 characters representing an ObjectId.
            - `avatar` string, required
            - `user` string, required
          - `paperId` string, required — A hex string of 24 characters representing an ObjectId.
      - 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' | 'container', required
        - `discussion` object, required
          - `num` number, required
          - `title` string, required
          - `status` 'draft' | 'open' | 'closed' | 'merged', required
          - `id` string, required — A hex string of 24 characters representing an ObjectId.
          - `isPullRequest` boolean, required
          - `participating` object[], required
            - `_id` string, required — A hex string of 24 characters representing an ObjectId.
            - `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 — A hex string of 24 characters representing an ObjectId.
            - `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 — A hex string of 24 characters representing an ObjectId.
            - `avatar` string, required
            - `user` string, required
  - `count` object, required
    - `view` number, required
    - `unread` number, required
    - `all` number, required
  - `start` number, required

## Changes

- **2026-09-18** `74f2b0d17636` — 1 warning, 1 info
  - added the new `container` enum value to the `notifications/items/oneOf[subschema #2]/repo/type` response property for the response status `200`
  - added the new enum value `container` to the `query` request parameter `repoType`
- **2026-09-08** `bd17546f47b8` — 1 breaking, 1 warning, 4 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `notifications/items/` response property `oneOf` list for the response status `200`
  - changed the pattern of the `query` request parameter `lastUpdate` from `^((\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-((0[13578]|1[02])-(0[1-9]|[12]\d|3[01])|(0[469]|11)-(0[1-9]|[12]\d|30)|(02)-(0[1-9]|1\d|2[0-8])))T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d+)?(Z)$` to `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$`
  - for the `query` request parameter `mention`, the type was generalized from no type to `string`
  - for the `query` request parameter `readStatus`, the type was generalized from no type to `string`
  - …2 more

[Change history](https://skmtc.dev/huggingface/apis/hub-api-endpoints/changes/api/notifications/get.md)

---

[API](https://skmtc.dev/huggingface/apis/hub-api-endpoints.md) · [All operations](https://skmtc.dev/huggingface/apis/hub-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc.dev/huggingface/apis/hub-api-endpoints/revisions/61b0b9b74a8a?raw)