---
title: "List items for a notification run (unified endpoint)"
method: GET
path: "/notification_runs/{run_id}/items"
tags: ["Notifications Runs"]
---

# List items for a notification run (unified endpoint)

`GET /notification_runs/{run_id}/items`

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.

## Path parameters

- `run_id` integer, required — ID of the notification run.

## Query parameters

- `page` integer — Page number (starts at 1).
- `page_size` integer — Items per page (1–1000, default 100).

## Response `200`

Items returned successfully.

- PaginatedRunItemsResponse — Paginated response for notification run items.
  - `items` unknown[], required — List of run items (LeakRunItem, RawRunItem, or DarkWebRunItem).
    - unknown
  - `total` integer, required — Total number of items in this run.
  - `total_unlocked` integer, required — Number of already-unlocked items.
  - `page` integer, required — Current page number.
  - `page_size` integer, required — Number of items per page.
  - `item_type` string, nullable — Primary item type in this run: 'leak', 'raw', or 'dark_web'.

## Other responses

- `401` — Authentication required.
- `404` — Run not found.
- `422` — Validation Error

---

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