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

# List deliveries to a channel

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

## Request

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

## Path parameters

- `id` string, required: Channel id (dest_...).

## Query parameters

- `limit` integer

## Response `200`

What the channel received, newest first: instant mentions and digest runs, with status and last error

- object
  - `data` object[], required
    - `id` string, required: Delivery id (dlv_...), also the webhook payload id.
    - `kind` 'mention' | 'digest' | 'event', required: mention: an instant rule's delivery. digest: a daily or weekly summary. event: an account event the channel subscribed to.
    - `event` string, required: The event name the payload carried: the rule's (mention.matched unless it set one, digest for a summary) or the account event's.
    - `status` 'pending' | 'delivered' | 'failed', required
    - `attempts` integer, required
    - `error` string, nullable, required: The last failure, when there was one.
    - `sentAt` string, nullable, required: ISO 8601 timestamp, UTC.
    - `createdAt` string, required: ISO 8601 timestamp, UTC.
    - `alert` object, required: The alert that produced it; name only, since alerts can be deleted. name is null for an account event, which no rule produces.
      - `name` string, nullable, required
    - `mention` object, nullable, required: For mention deliveries: the post, text cut to 160 characters.
      - `id` string, required
      - `url` string, required
      - `text` string, required

## Other responses

- `401`: Missing or invalid API key
- `404`: Channel not found

---

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