Skip to main content
GET
cURL

Path Parameters

id
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
matches_limit
integer<int64>
default:100

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.

Required range: 1 <= x <= 100
matches_cursor
string

Opaque cursor from a previous response's matches_cursor, to fetch the next page of embedded matches.

Response

OK

alert_id
string
required

ID of the parent alert.

channel
string
required
created_at
string<date-time>
required
has_webhook_payload
boolean
required

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.

id
string
required
match_count
integer<int64>
required
matches
object[] | null
required
matches_has_more
boolean
required

Whether more matches exist beyond this page. The true total is match_count.

monitor_id
string
required

Deprecated — use alert_id. ID of the parent alert.

status
string
required

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).

viewer_can_manage
boolean
required

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.

alert
object

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

error_message
string
matches_cursor
string

Opaque cursor; pass as ?matches_cursor= to fetch the next page of matches. Absent when there are no more.

monitor
object

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

sent_at
string<date-time>