API ReferenceDeliveries
List deliveries
Every attempt to deliver an event, with the request and the endpoint's response.
GET/v1/deliveries
A delivery is one attempt to send one event to one endpoint. Use this to debug failures or to show a log to your customers.
Query parameters
event_idstring
Only attempts for this event.
endpoint_idstring
Only attempts to this endpoint.
succeededboolean
true for 2xx responses, false for everything else.limitintegerdefault: 20
See Pagination.
Request
curl -G https://api.relay.dev/v1/deliveries \
-H "Authorization: Bearer $RELAY_API_KEY" \
-d endpoint_id=ep_7Hn3LpQ9 \
-d succeeded=falseconst { data } = await relay.deliveries.list({ endpointId: "ep_7Hn3LpQ9", succeeded: false });deliveries = relay.deliveries.list(endpoint_id="ep_7Hn3LpQ9", succeeded=False)Response
{
"object": "list",
"data": [
{
"id": "dlv_Qm81aXr4",
"object": "delivery",
"event_id": "evt_9fK2mLq81",
"endpoint_id": "ep_7Hn3LpQ9",
"attempt": 3,
"status_code": 503,
"duration_ms": 15000,
"error": "timeout",
"response_body": "upstream connect error",
"created_at": "2026-10-14T09:36:20Z"
}
],
"has_more": true
}response_body holds the first 4 KB of the endpoint's response for 4xx and 5xx answers.