---
title: "List a channel's deliveries"
method: GET
path: "/v1/channels/{id}/deliveries"
tags: ["Alerts"]
---

# List a channel's deliveries

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

## Request

- Base URL: `https://api.rumoro.dev`
- URL: `https://api.rumoro.dev/v1/channels/{id}/deliveries`
- Auth: HTTP bearer

Lists the mentions, digests and account events sent to the channel, latest first, with status and the last error. `limit` defaults to 50, up to 200.

## Path parameters

- `id` string, required: The channel's id (dest_...).

## Query parameters

- `limit` integer

## Response `200`

Everything sent to the channel, latest first, including instant mentions and digests, with status and the last error

- object
  - `data` object[], required
    - `id` string, required: The delivery's id (dlv_...), which is also the webhook payload's id.
    - `kind` 'mention' | 'digest' | 'event', required: mention is a delivery from an instant alert. digest is a scheduled summary. event is an account event the channel subscribed to.
    - `event` string, required: The event name in the payload. For an alert it is mention.matched unless the alert set its own, or digest for a summary. For an account event it is that event's name.
    - `status` 'pending' | 'delivered' | 'failed', required
    - `attempts` integer, required
    - `error` string, nullable, required: The latest error, if any.
    - `sentAt` string, nullable, required: UTC time in ISO 8601.
    - `createdAt` string, required: UTC time in ISO 8601.
    - `alert` object, required: Name of the sending alert, kept because alerts can be deleted. Null name for account events, which no alert sends.
      - `name` string, nullable, required
    - `mention` object, nullable, required: Set on mention deliveries. Holds the post, with text shortened to 160 characters.
      - `id` string, required
      - `url` string, required
      - `text` string, required

## Other responses

- `401`: The API key is missing or not valid
- `404`: No channel with this id

---

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