cURL

curl "https://api.particle.pro/v1/alerts/deliveries/{id}?view=summary"

{
  "alert_id": "<string>",
  "channel": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "match_count": 123,
  "matches": [
    {
      "alert_id": "<string>",
      "deliveries": [
        {
          "channel": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "id": "<string>",
          "status": "<string>",
          "error_message": "<string>",
          "sent_at": "2023-11-07T05:31:56Z"
        }
      ],
      "detected_at": "2023-11-07T05:31:56Z",
      "entity_id": "<string>",
      "entity_type": "<string>",
      "id": "<string>",
      "mention_count": 123,
      "monitor_id": "<string>",
      "source_id": "<string>",
      "source_type": "<string>",
      "episode": {
        "podcast_id": "<string>",
        "podcast_title": "<string>",
        "title": "<string>",
        "apple_podcasts_url": "<string>",
        "duration_seconds": 123,
        "explicit": true,
        "image_url": "<string>",
        "podcast_image_url": "<string>",
        "podcast_slug": "<string>",
        "published_at": "2023-11-07T05:31:56Z",
        "slug": "<string>"
      },
      "is_backfilled": true,
      "llm_summary": "<string>",
      "mention_variants": [
        "<string>"
      ],
      "roles": [
        "<string>"
      ],
      "salience": 123,
      "truncated": true,
      "windows": [
        {
          "end_seconds": 123,
          "lines": [
            {
              "end_seconds": 123,
              "start_seconds": 123,
              "text": "<string>",
              "is_mention": true,
              "number": 123,
              "role": "<string>",
              "speaker": "<string>"
            }
          ],
          "start_seconds": 123,
          "segment_id": "<string>",
          "segment_title": "<string>",
          "segment_type": "<string>"
        }
      ]
    }
  ],
  "monitor_id": "<string>",
  "status": "<string>",
  "alert": {
    "id": "<string>",
    "title": "<string>",
    "organization_id": "<string>",
    "project_id": "<string>"
  },
  "error_message": "<string>",
  "monitor": {
    "id": "<string>",
    "title": "<string>",
    "organization_id": "<string>",
    "project_id": "<string>"
  },
  "sent_at": "2023-11-07T05:31:56Z"
}

Alerts

Get a single alert delivery

Returns one delivery with its embedded matches. The URL is keyed only by the delivery ID — the parent alert ID is intentionally omitted so a landing-page link can be shared publicly without leaking the alert identifier. Works for all cadences — immediate, daily, weekly digests. URL possession is the access factor; the endpoint is reachable without auth (the IDs are unguessable). Authenticated members of the delivery’s owning organization receive the high-resolution payload (transcript Windows when view=detailed, mention variants, salience, delivery audit). Unauthenticated and non-member callers receive a reduced public payload — alert title and kind, match entity and episode metadata, no internal fields.

GET

alerts

deliveries

{id}

cURL

curl "https://api.particle.pro/v1/alerts/deliveries/{id}?view=summary"

{
  "alert_id": "<string>",
  "channel": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "match_count": 123,
  "matches": [
    {
      "alert_id": "<string>",
      "deliveries": [
        {
          "channel": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "id": "<string>",
          "status": "<string>",
          "error_message": "<string>",
          "sent_at": "2023-11-07T05:31:56Z"
        }
      ],
      "detected_at": "2023-11-07T05:31:56Z",
      "entity_id": "<string>",
      "entity_type": "<string>",
      "id": "<string>",
      "mention_count": 123,
      "monitor_id": "<string>",
      "source_id": "<string>",
      "source_type": "<string>",
      "episode": {
        "podcast_id": "<string>",
        "podcast_title": "<string>",
        "title": "<string>",
        "apple_podcasts_url": "<string>",
        "duration_seconds": 123,
        "explicit": true,
        "image_url": "<string>",
        "podcast_image_url": "<string>",
        "podcast_slug": "<string>",
        "published_at": "2023-11-07T05:31:56Z",
        "slug": "<string>"
      },
      "is_backfilled": true,
      "llm_summary": "<string>",
      "mention_variants": [
        "<string>"
      ],
      "roles": [
        "<string>"
      ],
      "salience": 123,
      "truncated": true,
      "windows": [
        {
          "end_seconds": 123,
          "lines": [
            {
              "end_seconds": 123,
              "start_seconds": 123,
              "text": "<string>",
              "is_mention": true,
              "number": 123,
              "role": "<string>",
              "speaker": "<string>"
            }
          ],
          "start_seconds": 123,
          "segment_id": "<string>",
          "segment_title": "<string>",
          "segment_type": "<string>"
        }
      ]
    }
  ],
  "monitor_id": "<string>",
  "status": "<string>",
  "alert": {
    "id": "<string>",
    "title": "<string>",
    "organization_id": "<string>",
    "project_id": "<string>"
  },
  "error_message": "<string>",
  "monitor": {
    "id": "<string>",
    "title": "<string>",
    "organization_id": "<string>",
    "project_id": "<string>"
  },
  "sent_at": "2023-11-07T05:31:56Z"
}

Path Parameters

string

required

Delivery ID

Query Parameters

view

enum<string>

default:summary

Hydration depth for the embedded matches. Both views include Episode metadata (episode title, podcast title, image) so the FE can render a card per match. 'summary' (default) omits transcript Windows; 'detailed' includes them — pick 'detailed' when rendering a full landing page where each match expands to the spoken excerpt, 'summary' for a list view.

Available options:

summary,

detailed

Response

alert_id

string

required

ID of the parent alert.

channel

string

required

created_at

string<date-time>

required

string

required

match_count

integer<int64>

required

matches

object[] | null

required

Show child attributes

monitor_id

string

required

Deprecated — use alert_id. ID of the parent alert.

status

string

required

alert

object

Lightweight reference to the parent alert. Lets the FE render a delivery landing page without a second GET /v1/alerts/{id} call.

Show child attributes

error_message

string

monitor

object

Deprecated — use alert. Lightweight reference to the parent alert.

Show child attributes

sent_at

string<date-time>

Introduction Preview alert disable action

⌘I