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"const event = await relay.events.retrieve("evt_9fK2mLq81");event = relay.events.retrieve("evt_9fK2mLq81")Response
{
"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.