---
title: "List Notifications"
method: POST
path: "/v1/notifications/list"
tags: ["Notifications"]
---

# List Notifications

`POST /v1/notifications/list`

List all notifications for the user's organization.

## Query parameters

- `limit` integer, nullable
- `page_size` integer, nullable
- `offset` integer, nullable
- `page` integer, nullable
- `cursor` string, nullable
- `next_cursor` string, nullable
- `after` string, nullable
- `include_total` boolean

## Request body

- ListNotificationsRequest — Request model for listing notifications.
  - `notification_type` 'pipeline_success' | 'pipeline_failure' | 'feature_extraction_success' | 'feature_extraction_failure' | 'system_alert' | 'billing_alert' | 'quota_alert' | 'audit_alert' | 'maintenance_alert' | 'custom' | 'onboarding_nudge' | 'engagement_nudge' | 'feature_tip' — Enum for notification types.
  - `priority` 'low' | 'medium' | 'high' | 'critical' — Enum for notification priority levels.
  - `read` boolean, nullable — Filter by read status
  - `user_id` string, nullable — Filter by user ID

## Response `200`

Successful Response

- ListNotificationsResponse — Response model for listing notifications.
  - `results` Notification[], required — List of notifications
    - `id` string — Unique ID
    - `type` 'pipeline_success' | 'pipeline_failure' | 'feature_extraction_success' | 'feature_extraction_failure' | 'system_alert' | 'billing_alert' | 'quota_alert' | 'audit_alert' | 'maintenance_alert' | 'custom' | 'onboarding_nudge' | 'engagement_nudge' | 'feature_tip', required — Enum for notification types.
    - `priority` 'low' | 'medium' | 'high' | 'critical', required — Enum for notification priority levels.
    - `title` string, required — Notification title
    - `content` string, required — Notification content
    - `created_at` string, date-time — Creation timestamp
    - `organization_id` string, required — Organization ID
    - `user_id` string, nullable — User ID (if applicable)
    - `metadata` object — Additional metadata
    - `delivery_status` object — Delivery status by channel
    - `read` boolean — Whether the notification has been read
    - `read_at` string, date-time, nullable — When the notification was read
  - `pagination` object, required — Pagination information
  - `total` integer, required — Total number of notifications

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

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