Retrieve a webhook endpoint | MVS Developer Docs

Fetches a single webhook endpoint by id, scoped to the authenticated organization. The signing secret is never returned.

x-api-keystring

A scoped MvsPayApiKey, e.g. mvspay_live_…. Mint and scope keys from the dashboard (Settings → API Keys).

idstringRequired

The webhook endpoint id.

The webhook endpoint.

idstring

urlstringformat: "uri"

eventslist of strings

isActiveboolean

created_atdatetime

updated_atdatetime

descriptionstring or null

last_delivery_atdatetime or null

last_statusstring or null

failure_countinteger

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

1	{
2	"id": "whk_01HZX2sample",
3	"url": "https://example.com/webhooks/mvs-pay",
4	"events": [
5	"payment.succeeded",
6	"payment.failed"
7	],
8	"isActive": true,
9	"created_at": "2026-06-21T12:00:00.000Z",
10	"updated_at": "2026-06-21T18:30:00.000Z",
11	"description": "Production billing listener",
12	"last_delivery_at": "2026-06-21T18:30:00.000Z",
13	"last_status": "DELIVERED",
14	"failure_count": 0
15	}

$	curl https://pay.mvscloud.com/api/webhooks/id \
>	-H "x-api-key: <apiKey>"