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

# List my notifications

`GET /notifications`

## Request

- Base URL: `https://tasg.app/api/v1`
- URL: `https://tasg.app/api/v1/notifications`
- Auth: HTTP bearer

## Query parameters

- `unread_only` 'true' | 'false'
- `limit` integer
- `offset` integer

## Response `200`

Newest first. `unread_count` is the caller's total unread regardless of filters.

- object
  - `notifications` Notification[], required
    - `id` string, uuid, required
    - `type` string, required: `task_assigned`, `task_completed`, `comment_added`, `mention`, `dependency_unblocked`, `attachment_added` …
    - `message` string, required
    - `related_task_id` string, uuid, nullable
    - `related_user_id` string, uuid, nullable
    - `read` boolean, required
    - `created_at` string, date-time, required
  - `unread_count` integer, required

## Other responses

- `401`: Missing, invalid, expired or revoked credentials.
- `403`: Authenticated, but not allowed: not a member, insufficient project role or the API token lacks the required scope.
- `429`: Rate limited. Back off and retry after the window in the `RateLimit-*` headers.

---

[API](https://skmtc.dev/tasg/apis/tasg-api.md) · [All operations](https://skmtc.dev/tasg/apis/tasg-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tasg/apis/tasg-api/revisions/cd2a1dbaf5cf?raw)