WEBHOOKS

List webhook endpoints

GET


                    roadrunnerzw.com/api/v1/webhooks

Returns your registered endpoints with their subscribed events and recent delivery health. Secrets are never returned.

REQUEST

curl -X GET https://roadrunnerzw.com/api/v1/webhooks \
  -H 'Authorization: Bearer rr_live_your_key_id' \
  -H 'X-RR-Timestamp: $(date +%s)' \
  -H 'X-RR-Signature: $SIGNATURE'

RESPONSE 200

{
    "object": "list",
    "data": [
        {
            "id": "whk_01JAV3K2QX8M4N7P",
            "object": "webhook_endpoint",
            "url": "https://example.com/hooks/roadrunner",
            "events": [
                "delivery.dispatched",
                "delivery.delivered"
            ],
            "active": true,
            "consecutive_failures": 0,
            "last_success_at": "2026-09-21T14:31:00+02:00",
            "disabled_at": null,
            "created_at": "2026-09-20T09:00:00+02:00"
        }
    ]
}

Responses

200 OK

Your registered webhook endpoints and their recent health.

401 Unauthenticated

The signature, key or timestamp did not check out. Also returned for a revoked key, and for a timestamp more than 300 seconds from ours.

403 Forbidden

The key is valid but was not issued the scope this endpoint requires. Scopes are fixed at issue, so this needs a new key rather than a retry.

429 Too many requests

Too many requests for this client. Back off and retry; the response carries Retry-After and X-RateLimit-* headers.

{ "object": "list", "data": [ { "id": "whk_01JAV3K2QX8M4N7P", "object": "webhook_endpoint", "url": "https://example.com/hooks/roadrunner", "events": [ "delivery.dispatched", "delivery.delivered" ], "active": true, "consecutive_failures": 0, "last_success_at": "2026-09-21T14:31:00+02:00", "disabled_at": null, "created_at": "2026-09-20T09:00:00+02:00" } ] }