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

# Get All Notifications

`GET /notifications`

## Request

- Base URL: `https://am1.portal.api.nasuni.com`
- URL: `https://am1.portal.api.nasuni.com/notifications`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nasuni/apis/portal-api/docs/notifications/get.ts> (a function with typed inputs; its response is checked against the schema)

Get paginated notifications with optional filters.

Returns notifications from the last 15 minutes by default if no date range is specified.
Supports cursor-based pagination.

Args:
    filter_query: Filter parameters including dates, severity, category, appliance_name, volume_name and search

Returns:
    NotificationsDto: Paginated list of notifications

## Query parameters

- `start_date` string, date-time, nullable: Start date filter. If not provided, defaults to 15 minutes ago.
- `end_date` string, date-time, nullable: End date filter. If not provided, defaults to the current date and time.
- `severity` NotificationSeverity[], nullable: Defaults to all severities if not provided
- `category` NotificationCategory[], nullable: Defaults to all categories if not provided
- `sub_category` NotificationSubCategory[], nullable: Defaults to all sub-categories if not provided
- `appliance_name` string[], nullable: Defaults to all appliances if not provided
- `volume_name` string[], nullable: Defaults to all volumes if not provided
- `search` string, nullable: Search term for notifications
- `limit` integer
- `iterator_id` string, uuid, nullable
- `page` integer, nullable
- `sort_by` 'generated_at' | 'severity' | 'category' | 'appliance_name' | 'volume_name'
- `sort_direction` 'asc' | 'desc'
- `include_count` boolean

## Response `200`

Successful Response

- NotificationsDto: Forward-only cursor-based pagination for infinite scroll UX Designed for "Load more" pattern - no backward navigation, no page numbers. UI shows: "Showing latest X notifications" with "Load more" button.
  - `items` NotificationDto[]
    - `id` string, uuid, required
    - `account_id` string, uuid, required
    - `severity` 'ALERT' | 'ERROR' | 'WARNING' | 'INFO' | 'ADMIN', required
    - `category` 'Snapshots & Sync' | 'Restore & Recovery' | 'Cyber Resilience' | 'Encryption Keys' | 'Volume Management' | 'Cloud & Credentials' | 'Remote Access & GFL' | 'Hardware' | 'Network' | 'System Health & Performance' | 'Cache Management' | 'Software & Firmware Updates' | 'Licensing' | 'Directory Services' | 'Appliance Lifecycle' | 'Security & Access' | 'File IQ & Auditing'
    - `code_name` string, required
    - `message` string, required
    - `source` 'SYSTEM_GENERATED' | 'CUSTOMER_DEFINED'
    - `created_at` string, date-time, required
    - `generated_at` string, date-time, required
    - `sub_category` 'Snapshot' | 'Sync' | 'Snapshot Retention' | 'Success' | 'Errors' | 'User Actions' | 'Disaster Recovery' | 'Ransomware' | 'Antivirus' | 'Escrow' | 'Generation' | 'Account' | 'Remote Access' | 'Backup' | 'Delete' | 'Safe Delete' | 'UniFSCK' | 'Multiprotocol' | 'Sharing' | 'GFL' | 'Lock Arbiter' | 'GFA' | 'RAID' | 'Encryption' | 'Exception' | 'Firmware' | 'UPS' | 'Unreachable' | 'Configuration' | 'Health Monitor' | 'NOC' | 'Limits' | 'Resources' | 'Cache Disk' | 'Metrics' | 'Config Backup' | 'Unsupported' | 'OS Disk' | 'Time' | 'Resize' | 'Eviction' | 'Autocache' | 'Pinning' | 'Sideload' | 'Power' | 'New' | 'Offline' | 'NMC' | 'SSO' | 'SSL Certificates' | 'EULA' | 'Remote Support' | 'File IQ' | 'AMQP' | 'Syslog'
    - `appliance_name` string, nullable
    - `appliance_serial` string, uuid, nullable
    - `volume_name` string, nullable
    - `volume_id` string, nullable
    - `arguments` object, nullable
    - `linked_doc` string, nullable
  - `metadata` NotificationPaginationMetadataDto, required
    - `iterator_id` string, uuid, nullable: Iterator ID for loading more results (null if no more)
    - `page_size` integer: Number of items returned
    - `total_pages` integer, nullable
    - `total_items` integer, required
    - `page` integer, nullable

## Other responses

- `400`: Invalid request parameters (e.g., invalid cursor, limit <= 0, date range > 30 days, cursor parameters mismatch)
- `401`: Not authenticated
- `403`: Insufficient permissions
- `408`: Database operation timed out
- `422`: Validation Error
- `500`: Database connection failed or internal server error

---

[API](https://skmtc.dev/nasuni/apis/portal-api.md) - [All operations](https://skmtc.dev/nasuni/apis/portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nasuni/apis/portal-api/revisions/2a505bec6d14?raw)