Skip to main content
GET
/
v1
/
webhooks
/
endpoints
/
{id}
/
deliveries
List webhook deliveries
curl --request GET \
  --url https://api.truthlocks.com/v1/webhooks/endpoints/{id}/deliveries \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "id": "<string>",
      "event_type": "<string>",
      "status_code": 123,
      "delivered_at": "<string>",
      "success": true
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt

Use this file to discover all available pages before exploring further.

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

Results are limited to the 50 most recent deliveries, sorted by creation time (newest first). Pagination is not currently supported.

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

​
id
string
required

Webhook endpoint ID

Query Parameters

​
limit
integer
default:20

Response

Delivery history

​
items
object[]