List webhook deliveries

GET/v1/webhooks/{id}/deliveriesAPI key

Each delivery is one event sent to this webhook. A delivery stays pending while it is being retried, and ends as success (your endpoint answered with a 2xx status) or failed. Results are ordered by creation time, newest first, and paginated with a cursor.

Path parameters

idstringpathrequired

The webhook ID.

Query parameters

limitnumberquerydefault: 25

How many deliveries to return, from 1 to 100.

cursorstringquery

The nextCursor from the previous page.

Response

dataWebhookDelivery[]

The deliveries.

Show delivery properties

idstring

The delivery ID, whd_…. Sent to your endpoint in the Flaresend-Delivery-Id header.

webhookIdstring

The webhook ID.

eventIdstring

The event ID, evt_…. Sent in the Flaresend-Event-Id header and as id in the payload. Test events start with evt_test_.

eventTypestring | null

For example email.delivered.

attemptnumber

How many times the delivery has been tried. 0 before the first try.

status'pending' | 'success' | 'failed'

pending while waiting or retrying.

responseCodenumber | null

The HTTP status of the last try. null when there was no response (timeout or network error).

responseBodystring | null

The first 1,024 characters of the last response body, or the error, for example timeout after 10s.

nextAttemptAtstring | null

When the next retry is due. null once the delivery is finished.

createdAtstring

ISO 8601 timestamp.

completedAtstring | null

When it ended as success or failed.

nextCursorstring | null

Pass it as cursor to get the next page. null on the last page.

Errors

Status	Code	When
404	`webhook_not_found`	No webhook with this ID in the project.

Request

import { Flaresend } from '@flaresend/client';

const flaresend = new Flaresend({
  apiKey: process.env.FLARESEND_API_KEY!,
  baseUrl: 'https://mailer.example.com',
});

const { data, nextCursor } = await flaresend.webhooks.deliveries(
  'wh_01K6B3C8R2M5T7V9X1Z3B5D7F9',
  { limit: 50 },
);

Response

{
  "data": [
    {
      "id": "whd_01K6B4F2H6K8M0P2R4T6V8X0Z2",
      "webhookId": "wh_01K6B3C8R2M5T7V9X1Z3B5D7F9",
      "eventId": "evt_01K6B4F1G5J7L9N1Q3S5U7W9Y1",
      "eventType": "email.delivered",
      "attempt": 1,
      "status": "success",
      "responseCode": 200,
      "responseBody": "ok",
      "nextAttemptAt": null,
      "createdAt": "2026-09-26T10:05:00.000Z",
      "completedAt": "2026-09-26T10:05:01.000Z"
    },
    {
      "id": "whd_01K6B4E9D3F5H7K9M1P3R5T7V9",
      "webhookId": "wh_01K6B3C8R2M5T7V9X1Z3B5D7F9",
      "eventId": "evt_01K6B4E8C2E4G6J8L0N2Q4S6U8",
      "eventType": "email.bounced",
      "attempt": 2,
      "status": "pending",
      "responseCode": 503,
      "responseBody": "Service Unavailable",
      "nextAttemptAt": "2026-09-26T10:06:30.000Z",
      "createdAt": "2026-09-26T10:04:00.000Z",
      "completedAt": null
    }
  ],
  "nextCursor": null
}

Path parametersCopy Anchor Link

Query parametersCopy Anchor Link

ResponseCopy Anchor Link

ErrorsCopy Anchor Link

Path parameters

Query parameters

Response

Errors