Skip to main content
GET
/
v1
/
webhooks
/
endpoints
/
{id}
/
deliveries
List deliveries
curl --request GET \
  --url https://api.example.com/v1/webhooks/endpoints/{id}/deliveries
[
  {
    "id": "dlv_a1b2c3d4",
    "endpoint_id": "660e8400-e29b-41d4-a716-446655440001",
    "event_id": "evt_x9y8z7w6",
    "event_type": "attestation.created",
    "payload_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "status": "delivered",
    "attempt_count": 1,
    "next_attempt_at": null,
    "last_error": null,
    "http_status": 200,
    "created_at": "2026-03-25T14:30:00Z",
    "updated_at": "2026-03-25T14:30:01Z"
  },
  {
    "id": "dlv_e5f6g7h8",
    "endpoint_id": "660e8400-e29b-41d4-a716-446655440001",
    "event_id": "evt_m3n4o5p6",
    "event_type": "verification.failed",
    "payload_hash": "a1b2c3d4e5f67890abcdef1234567890abcdef1234567890abcdef1234567890",
    "status": "failed",
    "attempt_count": 3,
    "next_attempt_at": "2026-03-25T14:30:00Z",
    "last_error": "connection timeout",
    "http_status": null,
    "created_at": "2026-03-25T14:25:00Z",
    "updated_at": "2026-03-25T14:29:00Z"
  }
]
Returns the most recent delivery attempts for a webhook endpoint (up to 50). Use this to monitor delivery health, debug failures, and verify that events are reaching your server.

Parameters

id
uuid
required
The ID of the webhook endpoint

Delivery statuses

StatusDescription
pendingDelivery is queued and has not been attempted yet
deliveredYour endpoint returned a 2xx status code
failedDelivery failed but may be retried
deadAll retry attempts exhausted — delivery permanently failed

Response fields

FieldTypeDescription
iduuidUnique identifier for the delivery attempt
endpoint_iduuidThe webhook endpoint this delivery belongs to
event_idstringUnique event identifier — use this to deduplicate retried events
event_typestringEvent type that triggered the delivery (e.g., attestation.created)
payload_hashstringSHA-256 hash of the delivered payload
statusstringCurrent delivery status: pending, delivered, failed, or dead
attempt_countintegerTotal number of delivery attempts so far
next_attempt_atstringISO 8601 timestamp of the next retry, or null if no retry is scheduled
last_errorstringError message from the most recent failed attempt, or null if successful
http_statusintegerHTTP status code returned by your endpoint, if available
created_atstringISO 8601 timestamp when the delivery was first queued
updated_atstringISO 8601 timestamp of the most recent status change

Responses

[
  {
    "id": "dlv_a1b2c3d4",
    "endpoint_id": "660e8400-e29b-41d4-a716-446655440001",
    "event_id": "evt_x9y8z7w6",
    "event_type": "attestation.created",
    "payload_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "status": "delivered",
    "attempt_count": 1,
    "next_attempt_at": null,
    "last_error": null,
    "http_status": 200,
    "created_at": "2026-03-25T14:30:00Z",
    "updated_at": "2026-03-25T14:30:01Z"
  },
  {
    "id": "dlv_e5f6g7h8",
    "endpoint_id": "660e8400-e29b-41d4-a716-446655440001",
    "event_id": "evt_m3n4o5p6",
    "event_type": "verification.failed",
    "payload_hash": "a1b2c3d4e5f67890abcdef1234567890abcdef1234567890abcdef1234567890",
    "status": "failed",
    "attempt_count": 3,
    "next_attempt_at": "2026-03-25T14:30:00Z",
    "last_error": "connection timeout",
    "http_status": null,
    "created_at": "2026-03-25T14:25:00Z",
    "updated_at": "2026-03-25T14:29:00Z"
  }
]
Results are limited to the 50 most recent deliveries, sorted by creation time (newest first). Pagination is not currently supported.