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

# List Notifications

`GET /notifications`

## Request

- Base URL: `https://api.projectindi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.projectindi.com/notifications`
- Auth: none declared

List notifications for the current user.

## Query parameters

- `unread_only` boolean
- `limit` integer
- `offset` integer
- `types` string, nullable: Comma-separated notifications.type filter, e.g. 'notify.tagged,comment.added' (the clinic tag feed).

## Response `200`

Successful Response

- NotificationListResponse
  - `notifications` NotificationResponse[], required
    - `id` string, required
    - `type` string, required
    - `title` string, required
    - `body` string, nullable, required
    - `body_rich` string, nullable
    - `tags` NotificationTag[]
      - `junction_id` string, required
      - `name` string, required
    - `reaction` string, nullable
    - `actor_name` string, required
    - `actor_type` string, required
    - `resource_type` string, required
    - `resource_id` string, nullable, required
    - `child_id` string, nullable, required
    - `child_name` string
    - `is_read` boolean, required
    - `created_at` string, required
  - `total` integer, required
  - `unread_count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/projectindi/apis/indi-agent-api-first-principles.md) - [All operations](https://skmtc.dev/projectindi/apis/indi-agent-api-first-principles/llms.txt) - [OpenAPI document](https://skmtc.dev/projectindi/apis/indi-agent-api-first-principles/revisions/25a7813e21fd?raw)