List webhooks

GET

/v1/webhooks

Requires WEBHOOKS_READ, granted by WEBHOOKS_WRITE (bundles)

Returns your business's webhooks, newest first. Keys restricted to sub-accounts can't use this endpoint.

Responses

Content-Type

application/json

JSON

[

{

"identifier": "0b8f5d2e-7a41-4c3b-9e6d-2f1a8c7b5e90",

"scopeKind": "ENTITY",

"scopeLabel": "Entity",

"url": "https://hooks.example.com/valr",

"eventTypes": [

"FIAT_DEPOSIT_CREDITED",

"FIAT_WITHDRAWAL_STATUS_UPDATE"

"active": true,

"description": "Treasury reconciliation",

"signingSecretFingerprint": "7477002c",

"createdAt": "2026-10-23T08:00:00.214367Z",

"updatedAt": "2026-10-23T08:00:00.214367Z"

{

"identifier": "9a4c7e1f-2b6d-4f8a-8c3e-5d7b9f1a3c6e",

"scopeKind": "ENTITY",

"scopeLabel": "Entity",

"url": "https://ops.example.com/hooks/crypto",

"eventTypes": [

"CRYPTO_DEPOSIT_CREDITED",

"SEND_STATUS_UPDATE"

"active": false,

"signingSecretFingerprint": "c19e04ab",

"createdAt": "2026-10-01T13:42:07.581902Z",

"updatedAt": "2026-10-20T09:05:44.017356Z"

}

]