API Reference

List Webhook Events

GET /webhooks/:id/events — the events sent to one webhook endpoint, newest first.

GET/webhooks/:id/events

Lists what SendDart sent to one webhook endpoint, newest first. One entry is one event: its id is the svix-id header your handler received, and every retry and replay of it reuses that id. status sums up its attempts so far.

`status`Meaning
deliveredAt least one attempt got a 2xx answer.
retryingNo 2xx yet, and an automatic retry is still due.
failedNo 2xx, and no automatic retry is left. You can still replay it.
Needs an API key with read access.
Path parameters
idstringrequired

The webhook id.

Query parameters
limitnumberoptional

Events per page, 1 to 100. Default 20.

afterstringoptional

An event id (msg_…). Returns the older events after it, for the next page. There is no before.

statusstringoptional

Only events with this status: delivered, failed or retrying.

typestringoptional

Only events of this type, such as email.bounced. event is accepted as another name for it.

const res = await fetch('https://www.senddart.com/api/webhooks/17/events?status=failed', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);

Response

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "webhook_event",
      "id": "msg_5c1e9a0f3b7d2e84a6c1",
      "webhook_id": "17",
      "type": "email.bounced",
      "status": "failed",
      "attempts": 5,
      "response_status": 500,
      "error": null,
      "created_at": "2026-11-21T10:15:32.118Z",
      "last_attempt_at": "2026-11-21T12:51:40.006Z"
    }
  ]
}

response_status and error come from the latest attempt: the HTTP status your endpoint answered with, or the reason there was no answer (a timeout, a refused connection). A limit outside 1–100, an after that is not an event id, or an unknown status returns 422 validation_error. A webhook that is not yours returns 404 not_found.