Sign in
Notifications Runs

List items for a notification run (unified endpoint)

Return items associated with a specific notification run. Supports all notification types:

  • Credential leaks (EMAIL, DOMAIN, ADVANCED): Fetches leak details from ES
  • RAW: Returns file metadata stored in DB
  • DARK_WEB: Fetches post details from ES

Pagination

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

Response PaginatedRunItemsResponse with items, total, total_unlocked, page, page_size, item_type.

Errors

  • 401 Authentication required, or invalid/expired API key.
  • 404 Run not found.
  • 422 Request validation error.
get/notification_runs/{run_id}/items

Path parameters

run_idinteger required

ID of the notification run.

ID of the notification run.

Query parameters

pageinteger

Page number (starts at 1).

Page number (starts at 1).

page_sizeinteger

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

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

Response

Items returned successfully.

totalinteger required

Total number of items in this run.

total_unlockedinteger required

Number of already-unlocked items.

pageinteger required

Current page number.

page_sizeinteger required

Number of items per page.

item_typestring nullable

Primary item type in this run: 'leak', 'raw', or 'dark_web'.

Changes

No recorded changes to this endpoint across all 1 revision of this API.