Events API

Inspect and replay captured webhook events

An event represents a single incoming HTTP request that was captured by one of your endpoints. Each event stores the full request headers, body, and delivery status.

---

List events

Returns a paginated list of events for an endpoint, ordered by received time (newest first).

curl "https://hookdrop.dev/api/endpoints/ENDPOINT_ID/events?status=failed&page=1&limit=25" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Path parameters

id · string · required

The endpoint ID.

Query parameters

status · string

Filter by delivery status. One of: received, delivered, failed, dead_letter.

from · string

Return only events received at or after this time. Accepts an ISO 8601 date string (e.g. 2026-04-01T00:00:00.000Z).

q · string

Full-text search within the event payload body.

page · number · default: "1"

Page number to retrieve.

limit · number · default: "50"

Number of results per page.

Response

{
  "events": [
    {
      "id": "e1f2a3b4-c5d6-7890-abcd-ef1234567890",
      "endpoint_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "delivered",
      "method": "POST",
      "headers": {
        "content-type": "application/json",
        "x-stripe-signature": "t=1680000000,v1=abc123..."
      },
      "body": "{\"type\":\"payment_intent.succeeded\",\"data\":{\"object\":{\"amount\":1500}}}",
      "received_at": "2026-04-01T12:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 142,
    "pages": 6
  }
}

events · array · required

List of event objects.

Show event properties

id · string

Unique identifier for the event.

endpoint_id · string

ID of the endpoint that captured this event.

status · string

Current delivery status: received, delivered, failed, or dead_letter.

method · string

HTTP method of the original request (e.g. POST).

headers · object

HTTP headers from the original request.

body · string

Raw request body as a string.

received_at · string

ISO 8601 timestamp of when the event was captured.

pagination · object · required

Pagination metadata.

Show pagination properties

page · number

Current page number.

limit · number

Results per page.

total · number

Total number of matching events.

pages · number

Total number of pages.

---

Get an event

Returns a single event with its full payload and delivery history.

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

Path parameters

id · string · required

The endpoint ID.

eId · string · required

The event ID.

Response

{
  "event": {
    "id": "e1f2a3b4-c5d6-7890-abcd-ef1234567890",
    "endpoint_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "delivered",
    "method": "POST",
    "headers": {
      "content-type": "application/json",
      "x-stripe-signature": "t=1680000000,v1=abc123..."
    },
    "body": "{\"type\":\"payment_intent.succeeded\",\"data\":{\"object\":{\"amount\":1500}}}",
    "received_at": "2026-04-01T12:00:00.000Z",
    "deliveries": []
  }
}

---

Replay an event

Re-enqueues an event for delivery to all currently configured destinations. Use this to retry a failed event or to test a new destination against a real payload.

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

Path parameters

id · string · required

The endpoint ID.

eId · string · required

The event ID.

Response

{
  "ok": true,
  "jobId": "42"
}

ok · boolean · required

true when the event was successfully enqueued.

jobId · string

Internal reference ID for the delivery job.