API Endpoint

GET /management/webhooks/deliveries

List recent webhook delivery runs and their retry/delivery status.

GET /management/webhooks/deliveries

Endpoint context

Use these endpoints from internal tooling or your frontend backend to inspect licenses, manage slug policy templates, provisioning API keys, webhook endpoint configuration/logs, and offline JWT signing keys. Management routes require the management bootstrap key configured via MANAGEMENT_API_KEYS or MANAGEMENT_API_KEY.

Requires management API key auth.
Returns the latest webhook delivery rows across configured endpoints.
Use the optional limit query parameter to control result count; default is 25 and max is 100.
Delivery rows are created only for endpoints that were enabled and subscribed when the event was emitted.

bash

curl -sS "http://localhost:8080/management/webhooks/deliveries?limit=25"   -H "Authorization: Bearer management_key_dev_123456"

Request body

json

{} (no request body; optional query parameter: limit)

Response body

json

{
  "deliveries": [
    {
      "id": 42,
      "endpoint_id": 1,
      "endpoint_name": "audit-sync",
      "endpoint_url": "https://example.com/hooks/license",
      "event_type": "license.generated",
      "status": "delivered",
      "attempts": 1,
      "last_response_status": 200,
      "last_error": null,
      "next_attempt_at": "2026-04-21T12:00:00Z",
      "created_at": "2026-04-21T12:00:00Z",
      "updated_at": "2026-04-21T12:00:01Z",
      "delivered_at": "2026-04-21T12:00:01Z"
    }
  ]
}

Response field types

deliveries

array

Recent webhook delivery run records.

deliveries[].id

number

Stable delivery id used in webhook headers.

deliveries[].endpoint_id

number

Webhook endpoint id.

deliveries[].endpoint_name

string

Endpoint name at read time.

deliveries[].endpoint_url

string

Endpoint URL at read time.

deliveries[].event_type

string

Webhook event type.

deliveries[].status

"pending" | "sending" | "delivered" | "failed"

Current delivery state.

deliveries[].attempts

number

Number of delivery attempts made.

deliveries[].last_response_status

number | null

Last HTTP status received from the endpoint.

deliveries[].last_error

string | null

Last delivery error, if any.

deliveries[].next_attempt_at

string

RFC3339 timestamp for the next retry when pending.

deliveries[].created_at

string

RFC3339 timestamp when the delivery was queued.

deliveries[].updated_at

string

RFC3339 timestamp when delivery state last changed.

deliveries[].delivered_at

string | null

RFC3339 timestamp when delivery succeeded.

Error codes

400

Invalid limit query parameter.

401

Missing or invalid management API key.

500

Unexpected server or storage error.

Back to API overview