List Deliveries

Returns a cursor-paginated log of an endpoint's recent deliveries.

GEThttps://api.audienceful.com/v2/webhooks/{id}/deliveries

curl --location --request GET 'https://api.audienceful.com/v2/webhooks/wYt3nKq8Zs4pLm9vRb2xJc/deliveries' \
--header 'X-Api-Key: <your-api-key>'

{
  "data": [
    {
      "id": "dLm4vRb2xJcwYt3nKq8Zs4",
      "event": "person.created",
      "payload": {
        "event": "person.created",
        "data": {
          "email": "person@example.com",
          "created_at": "2026-07-04T12:00:00Z",
          "extra_data": { "plan": "pro" },
          "audiences": ["Newsletter"],
          "tags": ["vip"],
          "double_opt_in": "not_required"
        }
      },
      "succeeded": true,
      "attempts": 1,
      "response_status": 200,
      "response_ms": 84,
      "error": "",
      "created_at": "2026-07-04T12:00:00Z",
      "completed_at": "2026-07-04T12:00:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Requires the webhooks:read scope. Returns the delivery attempts for a webhook endpoint, most recent first. Delivery log rows are retained for 30 days.

Path parameters

idstringrequired

The id of the webhook endpoint.

Query parameters

page_sizenumberdefault: 25

The number of deliveries to return per page.

cursorstring

The pagination cursor from a previous response's next_cursor. See Pagination.

Response

dataarray

The page of deliveries.

Properties

idstring

The delivery's unique id, matching the X-Audienceful-Delivery-Id header sent to your server.

eventstring

The event that was delivered (e.g. person.created, or ping for a test).

payloadobject

The full signed body that was (or will be) POSTed to your endpoint — the { "event": ..., "data": ... } envelope. Exposed so the log is a real debugging tool: you can see exactly what was sent for each delivery.

succeededboolean or null

Whether the delivery succeeded. null while a delivery is still in flight.

attemptsnumber

How many delivery attempts have been made.

response_statusnumber or null

The HTTP status code your server returned on the last attempt.

response_msnumber or null

How long your server took to respond, in milliseconds.

errorstring

The error from the last failed attempt, if any. Empty on success.

created_atstring

The datetime (UTC) the delivery was created.

completed_atstring or null

The datetime (UTC) the delivery finished, if it has.

has_moreboolean

Whether more deliveries exist after this page.

next_cursorstring or null

The cursor to pass as ?cursor= to fetch the next page.