---
title: "Get notifications"
method: GET
path: "/api/v2/notifications"
tags: ["Notifications"]
---

# Get notifications

`GET /api/v2/notifications`

List notifications.

## Query parameters

- `filter` union — Filter schema for `notification` list endpoints — pass a single condition or a logical group.
  - FilterNotification — Filter parameters for notifications.
    - `date_after` union — Filter notifications where the last action occurred on or after this date.
      - object — Filter using explicit operator syntax.
        - `not_contain` DateAfter — unresolved $ref
        - `not_eq` DateAfter — unresolved $ref
        - `contains` DateAfter — unresolved $ref
        - `eq` DateAfter — unresolved $ref
      - DateAfter — unresolved $ref
    - `type` union — Filter by notification type (the resource type that triggered the notification).
      - Type — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `contains` Type — unresolved $ref
        - `not_eq` Type — unresolved $ref
        - `not_contain` Type — unresolved $ref
        - `eq` Type — unresolved $ref
    - `dismissed` union — Filter to include only dismissed (or non-dismissed) notifications.
      - object — Filter using explicit operator syntax.
        - `eq` Dismissed — unresolved $ref
        - `contains` Dismissed — unresolved $ref
        - `not_contain` Dismissed — unresolved $ref
        - `not_eq` Dismissed — unresolved $ref
      - Dismissed — unresolved $ref
    - `after` union — Filter by after.
      - After — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_contain` After — unresolved $ref
        - `contains` After — unresolved $ref
        - `eq` After — unresolved $ref
        - `not_eq` After — unresolved $ref
    - `before` union — Filter by before.
      - object — Filter using explicit operator syntax.
        - `not_contain` Before — unresolved $ref
        - `eq` Before — unresolved $ref
        - `not_eq` Before — unresolved $ref
        - `contains` Before — unresolved $ref
      - Before — unresolved $ref
    - `project_id` union — Filter to notifications related to tasks or todos in the given project.
      - object — Filter using explicit operator syntax.
        - `not_eq` ProjectId — unresolved $ref
        - `not_contain` ProjectId — unresolved $ref
        - `contains` ProjectId — unresolved $ref
        - `eq` ProjectId — unresolved $ref
      - ProjectId — unresolved $ref
    - `mention` union — Filter to include only notifications that are direct mentions.
      - object — Filter using explicit operator syntax.
        - `not_eq` Mention — unresolved $ref
        - `not_contain` Mention — unresolved $ref
        - `contains` Mention — unresolved $ref
        - `eq` Mention — unresolved $ref
      - Mention — unresolved $ref
    - `important` union — Filter to include only high-importance notifications.
      - object — Filter using explicit operator syntax.
        - `not_eq` Important — unresolved $ref
        - `contains` Important — unresolved $ref
        - `eq` Important — unresolved $ref
        - `not_contain` Important — unresolved $ref
      - Important — unresolved $ref
    - `id` union — Filter by ID.
      - Id — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_contain` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
        - `contains` Id — unresolved $ref
        - `eq` Id — unresolved $ref
    - `last_action_at` union — Filter by the timestamp of the last action triggering this notification.
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `contains` LastActionAt — unresolved $ref
        - `not_contain` LastActionAt — unresolved $ref
        - `not_eq` LastActionAt — unresolved $ref
        - `eq` LastActionAt — unresolved $ref
      - LastActionAt — unresolved $ref
    - `date_before` union — Filter notifications where the last action occurred on or before this date.
      - object — Filter using explicit operator syntax.
        - `not_contain` DateBefore — unresolved $ref
        - `eq` DateBefore — unresolved $ref
        - `contains` DateBefore — unresolved $ref
        - `not_eq` DateBefore — unresolved $ref
      - DateBefore — unresolved $ref
  - object — A logical filter group — combine multiple conditions with the `$op` operator.
    - `$op` 'or' | 'and', required — Logical operator combining conditions in this group. `or` matches records satisfying any condition; `and` requires all conditions to match.
- `sort` string[]

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection notification

---

[API](https://skmtc.net/productive/apis/api-documentation.md) · [All operations](https://skmtc.net/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productive/api-documentation/revisions/11e8576224b8/schema)