Notifications

List notifications

Changed on

Return all notifications configured for the current account, including linked method info.

Response Array of objects with fields like id, method_id, type, second_type, value, filters, label, is_active, timestamp, method_type, method_name, method_value, auto_unlock, max_points, daily_spent, daily_reset_at, total_notifications, total_cost.

get/notifications

Request

Response

Notifications listed successfully.

idinteger required

Notification ID.

method_idinteger required

ID of the notification method used for delivery.

type'email' | 'domain' | 'advanced' | 'raw' | 'dark_web' required
dataset'stealer_logs' | 'combolist' | 'databases' | 'raw_files' | 'dark_web'

Dataset monitored by this notification: stealer_logs, combolist or databases for credential alerts (email, domain, advanced), raw_files for raw alerts, dark_web for dark web alerts.

second_type'ALL' | 'EMPLOYEES' | 'THIRD_PARTIES' | 'CUSTOMERS'
valuestring nullable

Monitored value (email address, domain, search query, etc.).

filtersobject nullable

Additional search filters applied to this notification.

labelstring nullable

Human label of the monitored asset: value when set, otherwise a summary of filters (raw, dark web and advanced alerts). Same label as the alert emails and the runs.

last_searched_atstring date-time nullable

Last time this notification was checked for new results.

is_activeboolean required

Whether this notification is currently active.

timestampstring date-time required

Creation date of this notification.

method_type'email' | 'slack' | 'telegram' | 'webhook' | 'discord'
method_namestring nullable

User-given label of the associated method, null when unnamed.

method_valuestring nullable

Destination of the associated method.

method_status'active' | 'suspended' | 'paused' nullable

Delivery state of the associated method (see status of notification methods). When it is not active, this notification keeps running but its alerts are not sent.

method_extra_emailsstring[] nullable

Additional BCC recipients of the associated method (email methods only).

auto_unlockboolean nullable

Whether new results are automatically unlocked.

max_pointsinteger nullable

Maximum points to spend per notification run for auto-unlock.

daily_spentinteger nullable

Points spent today by auto-unlock on this notification.

daily_reset_atstring date-time nullable

Next daily reset time for the spent counter.

total_notificationsinteger nullable

Total number of notification runs executed.

total_costinteger nullable

Total points consumed by this notification across all runs.

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status