---
title: "Get a notification run"
method: GET
path: "/notification_runs/{run_id}"
tags: ["Notifications Runs"]
---

# Get a notification run

`GET /notification_runs/{run_id}`

## Request

- Base URL: `https://api.leakradar.io`
- URL: `https://api.leakradar.io/notification_runs/{run_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/leakradar/apis/leakradar-io-api/docs/notification_runs/:run_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Return one notification run of the current account, with the label of its monitored asset. This is the run that alert emails, chat messages and webhooks (`run_url`) link to. Use `/notification_runs/{run_id}/items` for its results.

**Errors**
- 401 Authentication required, or invalid/expired API key.
- 404 Run not found (deleted, or owned by another account).

## Path parameters

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

## Response `200`

Run returned successfully.

- NotificationRunBase
  - `id` integer, required
  - `user_id` integer, required
  - `notification_id` integer, nullable
  - `sent_at` string, date-time, required
  - `new_leaks_count` integer, required
  - `unlocked_count` integer, required
  - `points_spent` integer, required
  - `sent_ok` boolean, required
  - `delivery_skipped` boolean
  - `notification_type` string, nullable
  - `notification_value` string, nullable
  - `notification_label` string, nullable
  - `notification_filters` object, nullable
  - `dataset` 'stealer_logs' | 'combolist' | 'databases' | 'raw_files' | 'dark_web'
  - `status` string

## Other responses

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

## Changes

- **2026-10-13** `180678ba6e6e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/leakradar/apis/leakradar-io-api/changes/notification_runs/:run_id/get.md)

---

[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.dev/leakradar/apis/leakradar-io-api/revisions/8dcd4b54cc4a?raw)