Retrieve a webhook endpoint

Get one endpoint with the events it receives.

Returns the endpoint with the events it receives. Only the responses that create an endpoint or rotate its secret include the secret; here, secret_hint shows its last four characters.

Path

id string Required

The webhook endpoint's ID, such as whk_GFAKLrE8wkBwF4WL.

Errors

404 not_found

No webhook endpoint with that ID belongs to your business.

Any request can also fail on its key or its body. See errors.

Request

curl "https://dash.402pay.co/api/v1/webhooks/whk_GFAKLrE8wkBwF4WL" \  -H "Authorization: Bearer $PAY402_SECRET_KEY"

Response200 OK

{  "data": {    "id": "whk_GFAKLrE8wkBwF4WL",    "kind": "webhook",    "url": "https://example.com/webhooks/402pay",    "description": "Fulfill orders",    "event_types": ["payment.succeeded", "payment.failed"],    "enabled": true,    "secret_hint": "whsec_••••X/LG",    "created_at": "2026-09-26T21:22:47.012Z",    "updated_at": "2026-09-26T21:22:47.012Z"  }}