---
title: "Get Notifications"
method: POST
path: "/notifications/get"
tags: ["Notifications"]
---

# Get Notifications

`POST /notifications/get`

## Request

- Base URL: `https://api.velt.dev/v2`
- URL: `https://api.velt.dev/v2/notifications/get`
- Auth: API key in header `x-velt-api-key` and API key in header `x-velt-auth-token`

Use this API to retrieve notifications.

**Requirements:**
- Enable advanced queries option in the Velt Console
- Deploy v4 series of the Velt SDK

## Request body

- object
  - `data` object, required
    - `organizationId` string, required: Organization ID
    - `documentId` string: Document ID (either this or userId)
    - `locationId` string: Location ID
    - `userId` string: User ID (either this or documentId)
    - `notificationIds` string[]: Array of Notification IDs (max 30)
    - `pageSize` integer: Number of items per page
    - `pageToken` string: Page token from previous API call
    - `order` 'asc' | 'desc': Order of notifications based on timestamp

## Response `200`

Notifications retrieved successfully

- object
  - `result` object
    - `status` string
    - `message` string
    - `data` object[]
    - `pageToken` string

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/velt-js/apis/velt-rest-api.md) - [All operations](https://skmtc.dev/velt-js/apis/velt-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/velt-js/apis/velt-rest-api/revisions/0f5af15fa267?raw)