Get a webhook

GET

/v1/webhooks/{id}

Requires WEBHOOKS_READ, granted by WEBHOOKS_WRITE (bundles)

Returns a webhook. The signing secret isn't included; to check which secret it uses, compare signingSecretFingerprint with the first 8 hex characters of the SHA-256 hash of the secret you stored. Keys restricted to sub-accounts can't use this endpoint.

Parameters

Path Parameters

id*

Webhook ID: the identifier returned when the webhook was created.

Type

string

Required

Example"0b8f5d2e-7a41-4c3b-9e6d-2f1a8c7b5e90"

Format

"uuid"

Responses

OK

Content-Type

application/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"

}

Samples

Errors

HTTP	Error	When
400	-11INVALID_REQUEST	The webhook ID isn't a valid UUID.
404	-18121WEBHOOK_SUBSCRIPTION_NOT_FOUND	No webhook with this ID exists for your business.

Plus the errors common to all signed endpoints.