Webhook deliveries

This endpoint returns your recent outbound webhook deliveries — the log of events fluxa has tried to POST to your endpoint, with their status, attempt count and last error. Use it to debug an endpoint that is rejecting or missing events. To learn how to receive and verify deliveries, see the Webhooks guide.

The delivery model

Name
id
Type
string
Description
The delivery id, prefixed whk_.
Name
event_type
Type
string
Description
The event type, e.g. payment.succeeded.
Name
payload
Type
object
Description
The JSON event body that was (or will be) sent.
Name
target_url
Type
string
Description
Your webhook URL at the time of the delivery.
Name
status
Type
string
Description
pending, success, or failed (terminal after the max attempts).
Name
attempts
Type
integer
Description
Number of delivery attempts made so far.
Name
next_retry_at
Type
timestamp
Description
When the next retry is scheduled, or null.
Name
last_error
Type
string
Description
The most recent failure reason, when any.
Name
delivered_at
Type
timestamp
Description
When the delivery first succeeded, or null.
Name
created_at
Type
timestamp
Description
When the delivery was enqueued.

GET/api/v1/webhooks

List deliveries

API keyAPI secret

Signed locally — your secret stays in this browser and is never sent or stored.

No keys yet? Create an API key pair in the merchant portal — the secret is shown only once. Open the merchant portal →

Query string

Return your most recent webhook deliveries as a plain data array.

Request

GET

/api/v1/webhooks

curl "$BASE/api/v1/webhooks" \
  -H "X-Api-Key: $KEY_ID" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature: $SIG"

Response

{
  "data": [
    {
      "id": "whk_5c",
      "event_type": "payment.succeeded",
      "target_url": "https://example.com/webhooks/fluxa",
      "status": "success",
      "attempts": 1,
      "next_retry_at": null,
      "last_error": "",
      "delivered_at": "2026-06-11T08:30:02Z",
      "created_at": "2026-06-11T08:30:00Z"
    }
  ]
}