---
title: "Query notifications (searchNotifications)"
method: POST
path: "/searchNotifications"
---

# Query notifications (searchNotifications)

`POST /searchNotifications`

Retrieves identity-related notifications for a specific period of time, such as merge events, link/unlink events, or other configured notifications.

## Request body

- ServiceRequestSearchNotifications
  - `content` SearchNotificationsWsRequest — Query notifications for the customer.
    - `pageNumber` integer, required — Page number.
    - `pageSize` integer, required — Page size.
    - `startDate` string, date-time, required — Start date.
    - `endDate` string, date-time, required — End date.
  - `trackingId` string

## Response `200`

Successful search notifications operation.

- ServiceResponseSearchNotifications
  - `auditId` string
  - `success` boolean
  - `warnings` string[]
  - `retryableError` boolean
  - `message` string
  - `content` SearchNotificationsWsResponse
    - `customerId` string — Name of the customer for the notifications.
    - `hasNext` boolean — Indicates whether more notifications are available.
    - `notifications` NotificationData[] — Notifications retrieved.
      - `partitionKey` string
      - `service` string
      - `customerId` string
      - `notificationLowerCaseBody` NotificationLowerCaseBody
        - `survivingSource` string
        - `retiredSource` string
        - `previousLinkId` string
        - `survivingNativeId` string
        - `newLinkId` string
        - `source` string
        - `nativeId` string
        - `retiredNativeId` string
      - `notificationType` string
      - `body` string
      - `ts` string, date-time
      - `username` string
    - `totalElements` integer — Number of notifications retrieved.
  - `errors` string[]
  - `trackingId` string

---

[API](https://skmtc.dev/verato/apis/verato-organization-api.md) · [All operations](https://skmtc.dev/verato/apis/verato-organization-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/verato/verato-organization-api/revisions/9ebf5a50437d/schema)