Deliveries API

View delivery attempts for a captured event

A delivery represents a single attempt to forward an event to one of your destinations. Hookdrop records every attempt, including the HTTP response code and body, so you can debug failures.

Each event can have multiple deliveries — one per destination, plus additional entries for each retry attempt.

---

List deliveries

Returns all delivery attempts for an event, ordered by time (newest first).

curl https://hookdrop.dev/api/endpoints/ENDPOINT_ID/events/EVENT_ID/deliveries \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Path parameters

id · string · required

The endpoint ID.

eId · string · required

The event ID.

Response

{
  "deliveries": [
    {
      "id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
      "event_id": "e1f2a3b4-c5d6-7890-abcd-ef1234567890",
      "destination": {
        "id": "d1e2f3a4-b5c6-7890-abcd-ef1234567890",
        "url": "https://your-server.com/webhooks"
      },
      "status": "delivered",
      "attempt_count": 2,
      "response_code": 200,
      "response_body": "OK",
      "last_attempted_at": "2026-04-01T12:00:45.000Z",
      "created_at": "2026-04-01T12:00:05.000Z"
    }
  ]
}

deliveries · array · required

List of delivery attempt objects.

Show delivery properties

id · string

Unique identifier for the delivery.

event_id · string

ID of the event this delivery belongs to.

destination · object

The destination this delivery was sent to.

Show destination properties

id · string

Destination ID.

url · string

The URL that was called.

status · string

Outcome of the delivery: delivered, failed, or dead_letter.

attempt_count · number

Total number of attempts made for this delivery, including retries.

response_code · number

HTTP status code returned by your destination server. null if the request could not be sent (e.g. connection timeout).

response_body · string

Response body returned by your destination server, truncated to the first 1 KB.

last_attempted_at · string

ISO 8601 timestamp of the most recent delivery attempt.

created_at · string

ISO 8601 timestamp of when the delivery was first created.