---
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 — Standard wrapper for all service requests.
  - `trackingId` string — Optional client-defined correlation ID.
  - `content` SearchNotificationsWsRequest — Query notifications for the customer.
    - `pageNumber` integer, required
    - `pageSize` integer, required
    - `startDate` string, date-time, required
    - `endDate` string, date-time, required

## Response `200`

Notifications search response

- ServiceResponseSearchNotifications — Standard wrapper for all service responses.
  - `auditId` string — Unique audit identifier for correlating requests and responses.
  - `success` boolean — Indicates whether the business operation succeeded.
  - `warnings` string[] — Non-fatal warnings generated by the operation.
  - `retryableError` boolean — Indicates whether an error is transient and the request may be retried.
  - `message` string — Human-readable status message.
  - `errors` string[] — Error messages if success is false.
  - `trackingId` string — Echo of the request trackingId, if provided.
  - `content` SearchNotificationsWsResponse
    - `customerId` string
    - `hasNext` boolean
    - `notifications` NotificationData[]
      - `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

---

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