---
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 notificiations for the customer
    - `pageNumber` integer, required — Page number
    - `endDate` string, date-time, required — End date
    - `pageSize` integer, required — page size
    - `startDate` string, date-time, required — Start date
  - `trackingId` string

## Response `200`

OK

- ServiceResponseSearchNotifications
  - `auditId` string
  - `success` boolean
  - `warnings` string[]
  - `retryableError` boolean
  - `message` string
  - `content` SearchNotificationsWsResponse
    - `customerId` string — The name of the customer for the notifications
    - `hasNext` boolean — Boolean to determinate if there are more elements
    - `notifications` NotificationData[] — The 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 — The number of notifications retrieved
  - `errors` string[]
  - `trackingId` string

---

[API](https://skmtc.net/verato/apis/verato-person-api.md) · [All operations](https://skmtc.net/verato/apis/verato-person-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/verato/verato-person-api/revisions/8225f2689816/schema)