Read the delivery log

GET /api/v1/admin/webhooks/deliveries prm_notifications_manage

One page of delivery attempts, newest first, without the payload bodies. This is where you diagnose an integration that is not receiving events.

failed and dead are different. failed means it will be retried, and next_attempt_at says when; dead means the attempt budget is spent and nothing further will happen without a replay. An integration that went quiet has rows in dead, not failed.

At a glance

Authentication: Staff token or session
Requires permission: prm_notifications_manage Manage notification channels & templates

Parameters

Parameter	Description
`filter[endpoint_id]` query · integer	Narrow to one endpoint. Also accepted as a bare endpoint_id parameter.
`filter[state]` query · enum	queued, sending, sent, failed or dead. An unknown value is a 400.
`sort` query · string	queued_at, state, attempts or id. Defaults to queued_at descending.

Errors

Code	When it is returned
`ERR_VALIDATION`400	an unknown state filter, or a non-numeric endpoint_id

Request

curl -X GET "$BASE/api/v1/admin/webhooks/deliveries" \
  -H "Authorization: Bearer $XR_TOKEN"

Response 200 OK

{
  "data": [
    {
      "id": 77120,
      "endpoint_id": 4,
      "event_type": "user.created",
      "state": "failed",
      "attempts": 3,
      "max_attempts": 6,
      "response_code": 502,
      "response_ms": 1204,
      "last_error": "upstream returned 502",
      "url": "https://hooks.acme.example/xradius",
      "queued_at": "2026-09-20 09:00:00",
      "sent_at": "2026-09-20 09:04:11",
      "next_attempt_at": "2026-09-20 09:20:00"
    }
  ],
  "meta": { "page": 1, "page_size": 50, "total": 4102, "has_next": true }
}

BASE is your tenant host: the same address you sign in on.

Try it on your own network.

50 subscribers for 7 days. You pay nothing.

Try it free Talk to us