---
title: "Get a webhook delivery attempt"
method: GET
path: "/api/webhooks/deliveries/{heron_id}"
tags: ["Webhooks"]
---

# Get a webhook delivery attempt

`GET /api/webhooks/deliveries/{heron_id}`

## Request

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

Returns one sent or failed webhook attempt from the last 7 days, using the heron_id from the delivery list. payload is the JSON body sent and is only stored for failed attempts; it is null for sent ones. response_text is not truncated.

## Path parameters

- `heron_id` string, required

## Response `200`

Webhook delivery attempt

- WebhookDeliveryDetailSchema
  - `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
  - `payload` object, nullable
  - `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

- `404`: Delivery not found

## Changes

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

[Operation history](https://skmtc.dev/herondata/apis/heron-data-api/changes/api/webhooks/deliveries/:heron_id/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)