List deliveries
The webhook delivery log, newest first.
Returns the delivery log of your account. Filter by endpoint, by event or by status — for example, the ones that failed:
curl "$BACKEND_URL/v1/webhooks/deliveries?endpointId=<id>&status=failed&page=1&pageSize=20" \
-H "Authorization: Bearer mk_your_api_key"The list is newest first, so a new delivery pushes older ones to the next page. When walking pages, the same delivery can show up twice: deduplicate on id.
api_keyAuthorizationBearer <token>API key (mk_...)
page?integerPage number, starting at 1. Defaults to 1. A page beyond pagination.totalPages is not an error: it returns empty data.
1 <= value <= 90071992547409911pageSize?integerItems per page, from 1 to 100. Defaults to 20.
1 <= value <= 10020endpointId?stringOnly deliveries to this endpoint.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuideventId?stringOnly deliveries of this event (the id of the body).
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidstatus?stringOnly deliveries in this state.
"pending""delivered""failed"One page of the delivery log, newest first. A new delivery pushes the older ones one position down, so the same delivery can show up on two pages: deduplicate on id.
application/json- response
One page of the webhook delivery log.
data*array<>The deliveries of this page, newest first.
pagination*Where this page sits in the whole listing: the totals and whether there are pages before and after it.
curl -X GET "https://example.com/v1/webhooks/deliveries"{ "data": [ { "id": "d1e2f3a4-b5c6-4d7e-8f90-a1b2c3d4e5f6", "endpointId": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f", "eventId": "e1d2c3b4-a5f6-4e7d-8c9b-0a1b2c3d4e5f", "eventType": "connection.created", "status": "delivered", "attempt": 1, "responseCode": 200, "responseMs": 84, "error": null, "nextRetryAt": null, "deliveredAt": "2026-10-06T14:32:02.000Z", "createdAt": "2026-10-06T14:32:01.000Z", "updatedAt": "2026-10-06T14:32:02.000Z" } ], "pagination": { "page": 1, "pageSize": 20, "totalItems": 1, "totalPages": 1, "hasNext": false, "hasPrev": false }}