List Deliveries

GET /v1/endpoints/{uuid}/user-events/deliveries

The delivery log, newest first: each event, its user, and whether it was delivered, is pending (waiting or being retried: attempts of 9, next_attempt_at) or failed, with your app's last answer. 14 days are kept.

Path parameters

uuid string (uuid) Req
The endpoint's uuid from /endpoints.
before string (query)
An event id (evt_…): the events before it, for the next page (more says there are).
limit integer (query)
1 to 100, default 50.

Response (200 OK)

The page of events.

Errors

400 Bad Request
A limit out of range, or a before that isn't in this endpoint's log.
401 Unauthorized
Missing auth.
403 Forbidden
Your role lacks endpoints:read in the active account.
404 Not Found
No such endpoint in your active account.
503 Service Unavailable
User events aren't available yet. Try again in a few minutes.
Request
curl "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/user-events/deliveries?limit=50" \ -H "X-API-KEY: <your_api_key>"
CLI
ngris api endpoint-user-events deliveries 019bb1e4-e785-77d2-9966-c3cff31d0a0e --limit 50
Response — 200 OK
{ "deliveries": [ { "id": "evt_0193f0b0aa017a008b0000000000a001", "type": "user.roles_changed", "user_id": "0193f0b0-6666-7a00-8b00-000000000071", "email": "maria@acme.com", "created_at": "2026-11-19T15:44:20.117Z", "status": "delivered", "attempts": 1, "next_attempt_at": null, "last_attempt_at": "2026-11-19T15:44:20.301Z", "last_status": 204, "delivered_at": "2026-11-19T15:44:20.402Z" }, { "id": "evt_0193f0b0aa017a008b0000000000a002", "type": "user.created", "user_id": "0193f0b0-6666-7a00-8b00-000000000072", "email": "sam@acme.com", "created_at": "2026-11-19T15:31:05.511Z", "status": "pending", "attempts": 3, "next_attempt_at": "2026-11-19T15:48:00.000Z", "last_attempt_at": "2026-11-19T15:43:00.000Z", "last_status": 502, "last_error": "502 Bad Gateway", "delivered_at": null } ], "more": false }
Was this helpful?
On this page
List Deliveries
Was this helpful?