# Query notifications

Retrieves identity-related notifications for a specific period of time, such as merge events, link/unlink events, or other configured notifications. Results are paginated by pageNumber and pageSize.

Endpoint: POST /searchNotifications
Version: 2026.1.2
Security: bearerAuth

## Request fields (application/json):

  - `auditId` (string)
    Unique audit identifier for correlating requests and responses.

  - `auditLogMap` (object)
    Map of string keys to string values.

  - `trackingId` (string)
    Optional client-defined correlation ID.

  - `content` (object)
    Query notifications for the customer.

  - `content.pageNumber` (integer, required)

  - `content.pageSize` (integer, required)

  - `content.startDate` (string, required)

  - `content.endDate` (string, required)

## Response 200 fields (application/json):

  - `auditId` (string)
    Unique audit identifier for correlating requests and responses.

  - `success` (boolean)
    Indicates whether the business operation succeeded.

  - `unparsedJson` (string)
    Raw response payload, for debugging or migration.

  - `warnings` (array)
    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` (array)
    Error messages if success is false.

  - `trackingId` (string)
    Echo of the request trackingId, if provided.

  - `content` (object)

  - `content.customerId` (string)

  - `content.hasNext` (boolean)

  - `content.notifications` (array)

  - `content.notifications.partitionKey` (string)

  - `content.notifications.service` (string)

  - `content.notifications.notificationLowerCaseBody` (object)

  - `content.notifications.notificationLowerCaseBody.survivingSource` (string)

  - `content.notifications.notificationLowerCaseBody.retiredSource` (string)

  - `content.notifications.notificationLowerCaseBody.previousLinkId` (string)

  - `content.notifications.notificationLowerCaseBody.survivingNativeId` (string)

  - `content.notifications.notificationLowerCaseBody.newLinkId` (string)

  - `content.notifications.notificationLowerCaseBody.source` (string)

  - `content.notifications.notificationLowerCaseBody.nativeId` (string)

  - `content.notifications.notificationLowerCaseBody.retiredNativeId` (string)

  - `content.notifications.notificationType` (string)

  - `content.notifications.body` (string)

  - `content.notifications.ts` (string)

  - `content.notifications.username` (string)

  - `content.totalElements` (integer)