Notifications Runs

List notification runs

Changed on

Return paginated notification runs for the current user ordered by most recent first.

Pagination

  • page starts at 1.
  • page_size is 1 to 1000 (default 20).

Filters

  • dataset, status, sent_after (inclusive) and sent_before (exclusive).
  • notification_id: runs of one monitored asset.
  • q: a run or asset number (123 or #123), or text found in the monitored asset (its value, or the query of a raw or dark web alert).

Response Items, total, page and page_size, plus exportable_total (Stealer Logs and Combolist runs matching the filters across all pages) and export_run_limit. The filters apply to both counts. Each item carries notification_label, the human label of the monitored asset (null once the alert is deleted).

get/notification_runs

Request

Query parameters

pageinteger

Page number (starts at 1).

page_sizeinteger

Items per page (1–1000, default 20).

dataset'stealer_logs' | 'combolist' | 'databases' | 'raw_files' | 'dark_web' nullable
status'new' | 'in_progress' | 'fixed' | 'accepted_risk'
sent_afterstring date-time nullable

Inclusive start of the sent-at period.

sent_beforestring date-time nullable

Exclusive end of the sent-at period.

notification_idinteger nullable

Only the runs of this monitored asset.

qstring nullable

Run or asset number (123 or #123), or text found in the monitored asset.

Response

Notification runs listed successfully.

totalinteger required

Total number of matching items.

pageinteger required

Current page number.

page_sizeinteger required

Number of items per page.

blacklisted_valuestring nullable

If a filter value matched a blacklist entry, this field contains the matched value.

exportable_totalinteger required
export_run_limitinteger required

Example response

{
  "items": [],
  "page": 1,
  "page_size": 20,
  "total": 0
}

Changes

    • info

      added the new optional query request parameter notification_id

    • info

      added the new optional query request parameter q

    • 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

    • info

      added the new optional query request parameter dataset

    • info

      added the new optional query request parameter sent_after

    • info

      added the new optional query request parameter sent_before

    • info

      added the new optional query request parameter status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status