Skip to main content
Fetch a single alert’s full configuration — title, kind, cadence, watched entities (with names), and notification emails. Read-only. The default response is just the configuration. It is lean by default and expands: request include=["matches"] to embed the most recent matches the alert has caught, and include=["deliveries"] for the email delivery audit log. For the full, paginated match history with transcript excerpts, use particle_alert_list_matches.

​
Inputs

FieldTypeRequiredDefaultDescription
alert_idstringyes—Alert id from particle_alert_list or particle_alert_create.
includearray of enumsno[]Optional sections to embed: matches (the most recent matches the alert has caught), deliveries (the email delivery audit log).
match_limitinteger (1–25)no5How many recent matches to embed when include=["matches"]. Use particle_alert_list_matches for full pagination and transcript windows.

​
Output

A markdown document with the alert configuration (same shape as particle_alert_create): the title as an H2, **ID:**, **Kind:**, **Delivery:**, **Status:** rows, an optional **Description:** row, a ### Watching (N) entity list, and a **Notify:** row. When requested, a ### Recent matches (N) section embeds each match as a bullet naming the episode and mention count (with the episode slug), and a ### Recent deliveries (N) section lists each delivery as \id` · channel · status · N matches`. Sample (alert_id="dKxN6Ry2mL9pJ5qW", include=["matches"]): 
## OpenAI mentions

**ID:** dKxN6Ry2mL9pJ5qW
**Kind:** ENTITY_MENTION
**Delivery:** DAILY
**Status:** active

### Watching (1)

- **Sam Altman:** PERSON · 9rQ2pV…

- **Notify:** you@example.com

### Recent matches (2)

- The AI Daily (Acme Network) — 3 mentions
  - **Episode:** the-ai-daily-2026-06-15
- Tech Roundup — 1 mention (backfilled)
  - **Episode:** tech-roundup-ep-204
Passing output_format: "json" returns the same fields (plus matches/deliveries) as compact JSON.

​
Example

Agent calls: particle_alert_get {
  "alert_id": "dKxN6Ry2mL9pJ5qW",
  "include": ["matches", "deliveries"]
}