Skip to content
RelayDocumentation

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

Request

curl -G https://api.relay.dev/v1/deliveries \
  -H "Authorization: Bearer $RELAY_API_KEY" \
  -d endpoint_id=ep_7Hn3LpQ9 \
  -d succeeded=false

Response

200 OK
{
  "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.