---
title: "List webhook delivery attempts"
method: GET
path: "/api/webhooks/deliveries"
tags: ["Webhooks"]
---

# List webhook delivery attempts

`GET /api/webhooks/deliveries`

## Request

- Base URL: `https://app.herondata.io`
- URL: `https://app.herondata.io/api/webhooks/deliveries`
- Auth: API key in header `x-api-key`

Lists sent and failed webhook attempts from the last 7 days. HTTP status 0 marks a connection error.

## Query parameters

- `limit` integer
- `cursor` string
- `status` 'sent' | 'failed'
- `end_user_heron_id` string
- `interval_start` string, date-time
- `interval_end` string, date-time

## Response `200`

Webhook delivery attempts

- object
  - `_meta` object
    - `next_cursor` string, nullable
    - `per_page` integer
    - `total` integer, nullable: Matching deliveries, capped at 10,000. Counted on the first page only; null when a cursor is passed.
    - `total_capped` boolean, nullable: True when total hit the 10,000 cap. Null when a cursor is passed.
  - `webhook_deliveries` WebhookDeliverySchema[]
    - `attempt` integer, nullable: Number of attempts made in this delivery chain, including this one
    - `end_user_heron_id` string, nullable
    - `heron_id` string
    - `http_status` integer, nullable
    - `max_attempts` integer, nullable: Maximum attempts in this delivery chain
    - `next_retry_at` string, date-time, nullable
    - `occurred_at` string, date-time
    - `resend_of` string, nullable
    - `response_text` string, nullable
    - `response_truncated` boolean
    - `status` string
    - `topic` string, nullable
    - `trigger` 'automatic' | 'manual' | 'null', nullable
    - `webhook` WebhookDeliveryWebhook
      - `heron_id` string
      - `url` string, url

## Other responses

- `422`: Invalid filters or cursor

## Changes

- **2026-11-03** `bd8008e49534`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/herondata/apis/heron-data-api/changes/api/webhooks/deliveries/get.md)

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) - [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/herondata/apis/heron-data-api/revisions/1ec936e17fef?raw)