---
title: "List deliveries for an alert"
method: GET
path: "/v1/alerts/{id}/deliveries"
tags: ["Alerts", "tier:standard"]
---

# List deliveries for an alert

`GET /v1/alerts/{id}/deliveries`

## Request

- Base URL: `https://api.particle.pro`
- URL: `https://api.particle.pro/v1/alerts/{id}/deliveries`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Returns the email delivery audit log for the given alert.

## Path parameters

- `id` string, required: Alert ID

## Query parameters

- `limit` integer: Results per page
- `cursor` string: Opaque pagination cursor from previous response

## Response `200`

OK

- PageAlertDelivery
  - `cursor` string: Pass to next request for more results
  - `data` AlertDelivery[], nullable, required: List of results
    - `alert_id` string, required: ID of the parent alert.
    - `channel` string, required
    - `created_at` string, date-time, required
    - `error_message` string
    - `id` string, required
    - `match_count` integer, required
    - `matches` AlertMatchSummary[], nullable, required
      - `detected_at` string, date-time, required
      - `entity_id` string, required
      - `entity_type` string, required
      - `id` string, required
      - `keyword` string: KEYWORD_MENTION matches only: the phrase this match fired on.
      - `kind` 'ENTITY_MENTION' | 'PODCAST_SPEAKER' | 'KEYWORD_MENTION', required: Inherited from the parent alert's kind. See AlertMatch.kind.
      - `mention_count` integer, required
      - `source_id` string, required
      - `source_type` string, required
    - `monitor_id` string, required: Deprecated — use alert_id. ID of the parent alert.
    - `sent_at` string, date-time
    - `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).
  - `has_more` boolean, required: Whether more results exist

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/particle/apis/particle-api.md) · [All operations](https://skmtc.dev/particle/apis/particle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/particle/apis/particle-api/revisions/416ba82ab9d7?raw)