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

# GET /notifications

`GET /notifications`

Search and sort notifications by alertId, alertType, actorId, actorType, actorAccountId, category, and read. V1 notifications can be requested with includeV1Notifications.

## Path parameters

- `userId` string, required

## Query parameters

- `language` string — Source data set is api/v3.0/languages
- `timestamp__lte` string, date-time
- `timestamp__gte` string, date-time
- `alertId` string, uuid, nullable
- `alertType` string
- `actorId` string
- `actorType` string
- `actorAccountId` string
- `category` 'health' | 'video' | 'operational' | 'audit' | 'job' | 'security' | 'sharing'
- `read` boolean
- `status` 'pending' | 'bounced' | 'dropped' | 'deferred' | 'delivered' | 'sent' | 'outsideUsersSchedule' | 'notificationsDisabled' | 'noNotificationActions' | 'sendingFailed' | 'throttled' | 'unableToGetSettings'
- `includeV1Notifications` boolean
- `sort` string[]
- `pageToken` string
- `pageSize` integer

## Headers

- `Accept-Language` string — Source data set is api/v3.0/languages

## Response `200`

Notification results

- Notifications — Used to wrap results for a paginated response, containing information on how to retrieve further pages.
  - `nextPageToken` string, nullable, required — Token to retrieve the next page. The value of this token is passed into the field pageToken. This value can be null if there is no next page.
  - `prevPageToken` string, nullable, required — Token to retrieve the previous page. The value of this token is passed into the field pageToken. This value can be null of there is no previous page.
  - `results` object[], required — The result set from a collection API call.
    - `id` string, uuid
    - `timestamp` string, date-time
    - `createTimestamp` string, date-time
    - `sentTimestamp` string, date-time, nullable
    - `alertId` string, uuid, nullable
    - `alertType` string
    - `actorId` string
    - `actorName` string
    - `actorType` string
    - `actorAccountId` string
    - `userId` string
    - `accountId` string
    - `read` boolean
    - `status` 'pending' | 'sent' | 'outsideUsersSchedule' | 'notificationsDisabled' | 'noNotificationActions' | 'sendingFailed' | 'throttled' | 'unableToGetSettings'
    - `category` 'health' | 'video' | 'operational' | 'audit' | 'job' | 'security' | 'sharing'
    - `description` string
    - `notificationActions` string[]
    - `dataSchemas` string[]
    - `data` object

## Other responses

- `400` — The supplied object is invalid. Error detail will contain the validation error.
- `401` — You are not authenticated. Please authenticate and try again.
- `500` — Something went wrong in the server. Please try again.

---

[API](https://skmtc.net/eagleeyenetworks/apis/devices.md) · [All operations](https://skmtc.net/eagleeyenetworks/apis/devices/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eagleeyenetworks/devices/revisions/df57313de545/schema)