Skip to content
RelayDocumentation

API ReferenceEvents

Retrieve an event

Get one event with its payload and a delivery summary per endpoint.

GET/v1/events/{event_id}

Path parameters

event_idstringrequired
The ID of the event, like evt_9fK2mLq81.

Request

curl https://api.relay.dev/v1/events/evt_9fK2mLq81 \
  -H "Authorization: Bearer $RELAY_API_KEY"

Response

200 OK
{
  "id": "evt_9fK2mLq81",
  "object": "event",
  "type": "invoice.paid",
  "status": "failing",
  "created_at": "2026-10-14T09:31:12Z",
  "data": { "invoice_id": "in_1042", "amount": 4900, "currency": "usd" },
  "deliveries": [
    { "endpoint_id": "ep_2kq8XcV1", "status": "delivered", "attempts": 1, "last_status_code": 200 },
    { "endpoint_id": "ep_7Hn3LpQ9", "status": "failing", "attempts": 3, "last_status_code": 503, "next_attempt_at": "2026-10-14T10:06:40Z" }
  ]
}

Delivery summary

statusstring
pending, delivered, failing or failed for this endpoint.
attemptsinteger
Attempts made so far.
next_attempt_atstring | null
When Relay will try again, if it will.