curl https://xquik.com/api/v1/webhooks/15/deliveries \ -H "x-api-key: xq_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2" | jq
Path Parameters The webhook ID to retrieve deliveries for.
Response 200 OK
401 Unauthenticated
400 Invalid ID
404 Not Found
List of delivery attempts, most recent first. Returns up to 100 deliveries. Unique delivery identifier.
ID of the stream event that triggered this delivery.
Current delivery status: pending, delivered, failed, or exhausted.
Total number of delivery attempts made.
HTTP status code returned by your endpoint on the most recent attempt. Omitted if no attempt has been made yet.
Error message from the most recent failed attempt. Omitted on success.
ISO 8601 timestamp of when the delivery was queued.
ISO 8601 timestamp of successful delivery. Omitted if not yet delivered.
{ "deliveries" : [ { "id" : "501" , "streamEventId" : "9001" , "status" : "delivered" , "attempts" : 1 , "lastStatusCode" : 200 , "createdAt" : "2026-02-24T14:22:01.000Z" , "deliveredAt" : "2026-02-24T14:22:02.000Z" }, { "id" : "502" , "streamEventId" : "9002" , "status" : "failed" , "attempts" : 3 , "lastStatusCode" : 500 , "lastError" : "Internal Server Error" , "createdAt" : "2026-02-24T14:25:00.000Z" }, { "id" : "503" , "streamEventId" : "9003" , "status" : "exhausted" , "attempts" : 5 , "lastStatusCode" : 503 , "lastError" : "Service Unavailable" , "createdAt" : "2026-02-24T14:30:00.000Z" }, { "id" : "504" , "streamEventId" : "9004" , "status" : "pending" , "attempts" : 0 , "createdAt" : "2026-02-24T14:35:00.000Z" } ] }
{ "error" : "unauthenticated" }
Missing or invalid API key. Check the x-api-key header value. { "error" : "invalid_id" }
The provided webhook ID is not a valid format. No webhook exists with this ID, or it belongs to a different account. Delivery Statuses Status Description pendingDelivery is queued and waiting for the next attempt. deliveredYour endpoint returned a 2xx status code. Delivery is complete. failedThe most recent attempt failed (non-2xx response or network error). The system will retry with exponential backoff. exhaustedAll retry attempts have been used. The delivery will not be retried. Check your endpoint and create a new webhook if needed.
Deliveries follow an exponential backoff retry schedule. After each failed attempt, the wait time increases. Once all retries are exhausted, the status transitions to exhausted and no further attempts are made.
