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.