curl "https://api.particle.pro/v1/alerts/deliveries/{id}?view=summary&matches_limit=100"{
"alert_id": "<string>",
"channel": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"has_webhook_payload": true,
"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>",
"kind": "ENTITY_MENTION",
"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>",
"audio_url": "<string>",
"duration_seconds": 123,
"explicit": true,
"image_url": "<string>",
"podcast_bias": "EXTREME_LEFT",
"podcast_image_url": "<string>",
"podcast_popularity": 123,
"podcast_popularity_badge": "Top Podcast",
"podcast_slug": "<string>",
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>"
},
"is_backfilled": true,
"keyword": "<string>",
"llm_summary": "<string>",
"mention_variants": [
"<string>"
],
"relevance": "on_target",
"roles": [
"<string>"
],
"truncated": true,
"windows": [
{
"end_seconds": 123,
"lines": [
{
"end_seconds": 123,
"start_seconds": 123,
"text": "<string>",
"is_mention": true,
"number": 123,
"role": "<string>",
"speaker": "<string>",
"speaker_statement_characteristics": {
"certainty": "hedged",
"sentiment": "negative",
"specificity": "vague",
"temporal_orientation": "past"
}
}
],
"start_seconds": 123,
"clip_description": "<string>",
"clip_id": "<string>",
"clip_intro_statement": "<string>",
"clip_title": "<string>",
"clip_type": "<string>",
"segment_description": "<string>",
"segment_id": "<string>",
"segment_summary": "<string>",
"segment_title": "<string>",
"segment_type": "<string>"
}
]
}
],
"matches_has_more": true,
"monitor_id": "<string>",
"status": "<string>",
"viewer_can_manage": true,
"alert": {
"id": "<string>",
"kind": "ENTITY_MENTION",
"title": "<string>",
"organization_id": "<string>",
"project_id": "<string>"
},
"error_message": "<string>",
"matches_cursor": "<string>",
"monitor": {
"id": "<string>",
"kind": "ENTITY_MENTION",
"title": "<string>",
"organization_id": "<string>",
"project_id": "<string>"
},
"sent_at": "2023-11-07T05:31:56Z"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Get a single alert delivery
Returns one delivery with its embedded matches (paginated — see matches_cursor). 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). For a member-viewed WEBHOOK delivery, has_webhook_payload is true and the exact POSTed JSON is available from GET /v1/alerts/deliveries//webhook-payload (not embedded here — it can be many MB). Unauthenticated and non-member callers receive a reduced public payload — alert title and kind, match entity and episode metadata, no internal fields.
curl "https://api.particle.pro/v1/alerts/deliveries/{id}?view=summary&matches_limit=100"{
"alert_id": "<string>",
"channel": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"has_webhook_payload": true,
"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>",
"kind": "ENTITY_MENTION",
"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>",
"audio_url": "<string>",
"duration_seconds": 123,
"explicit": true,
"image_url": "<string>",
"podcast_bias": "EXTREME_LEFT",
"podcast_image_url": "<string>",
"podcast_popularity": 123,
"podcast_popularity_badge": "Top Podcast",
"podcast_slug": "<string>",
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>"
},
"is_backfilled": true,
"keyword": "<string>",
"llm_summary": "<string>",
"mention_variants": [
"<string>"
],
"relevance": "on_target",
"roles": [
"<string>"
],
"truncated": true,
"windows": [
{
"end_seconds": 123,
"lines": [
{
"end_seconds": 123,
"start_seconds": 123,
"text": "<string>",
"is_mention": true,
"number": 123,
"role": "<string>",
"speaker": "<string>",
"speaker_statement_characteristics": {
"certainty": "hedged",
"sentiment": "negative",
"specificity": "vague",
"temporal_orientation": "past"
}
}
],
"start_seconds": 123,
"clip_description": "<string>",
"clip_id": "<string>",
"clip_intro_statement": "<string>",
"clip_title": "<string>",
"clip_type": "<string>",
"segment_description": "<string>",
"segment_id": "<string>",
"segment_summary": "<string>",
"segment_title": "<string>",
"segment_type": "<string>"
}
]
}
],
"matches_has_more": true,
"monitor_id": "<string>",
"status": "<string>",
"viewer_can_manage": true,
"alert": {
"id": "<string>",
"kind": "ENTITY_MENTION",
"title": "<string>",
"organization_id": "<string>",
"project_id": "<string>"
},
"error_message": "<string>",
"matches_cursor": "<string>",
"monitor": {
"id": "<string>",
"kind": "ENTITY_MENTION",
"title": "<string>",
"organization_id": "<string>",
"project_id": "<string>"
},
"sent_at": "2023-11-07T05:31:56Z"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Path Parameters
Delivery ID
Query Parameters
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.
summary, detailed Max embedded matches to return in this response (default and max 100). The delivery's true total is always match_count; use matches_cursor to page through the rest.
1 <= x <= 100Opaque cursor from a previous response's matches_cursor, to fetch the next page of embedded matches.
Response
OK
ID of the parent alert.
Whether this delivery has a reconstructable webhook payload (member-viewed WEBHOOK deliveries only). When true, fetch the exact POSTed JSON from GET /v1/alerts/deliveries/{id}/webhook-payload — it is not embedded here because it can be many MB.
Show child attributes
Show child attributes
Whether more matches exist beyond this page. The true total is match_count.
Deprecated — use alert_id. ID of the parent alert.
Delivery outcome — SENT (delivered; a partial success keeps this status with the failure noted in error_message), FAILED (an attempt failed; realtime retries within its budget and digests re-select within their window), SKIPPED (intentionally not delivered), or ABANDONED (realtime webhook delivery permanently gave up after exhausting its retry budget, so the match was dropped for that channel).
Whether the caller is a member of the owning org (or an API key scoped to the owning project) and can manage this alert in-app. True responses carry the member-only fields; false responses are the public projection with those fields stripped. Clients must read this rather than inferring access from field presence.
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
Show child attributes
Opaque cursor; pass as ?matches_cursor= to fetch the next page of matches. Absent when there are no more.
Deprecated — use alert. Lightweight reference to the parent alert.
Show child attributes
Show child attributes
Was this page helpful?