Skip to main content
GET
/
webhooks
/
{webhookId}
/
events
/
{webhookEventId}
Get Webhook Event
curl --request GET \
  --url https://api.dfns.io/webhooks/{webhookId}/events/{webhookEventId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "date": "<string>",
  "kind": "policy.triggered",
  "data": {},
  "status": "<string>",
  "error": "<string>",
  "timestampSent": 123
}

​
Authentication

✅ Organization User (CustomerEmployee)
❌ Delegated User (EndUser)
✅ Service Account

​
Required Permissions

Webhooks:Events:Read: Always required.

Authorizations

​
Authorization
string
header
required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

Path Parameters

​
webhookId
string
required
Minimum length: 1
​
webhookEventId
string
required
Minimum length: 1

Response

200 - application/json

Success

WebhookEvent

​
id
string
required

WebhookEvent ID

​
date
string
required

ISO date string when event was raised

​
kind
enum<string>
required

Webhook event

Available options:
policy.triggered,
policy.approval.pending,
policy.approval.resolved,
key.created,
key.deleted,
key.delegated,
key.exported,
wallet.blockchainevent.detected,
wallet.created,
wallet.delegated,
wallet.exported,
wallet.signature.failed,
wallet.signature.rejected,
wallet.signature.requested,
wallet.signature.signed,
wallet.transaction.broadcasted,
wallet.transaction.confirmed,
wallet.transaction.failed,
wallet.transaction.rejected,
wallet.transaction.requested,
wallet.transfer.broadcasted,
wallet.transfer.confirmed,
wallet.transfer.failed,
wallet.transfer.rejected,
wallet.transfer.requested,
wallet.offer.received,
wallet.offer.accepted,
wallet.offer.rejected,
wallet.tags.modified
​
data
object
required
​
status
string
required

Status code of the webhook request

​
timestampSent
integer
required

Unix timestamp when the event was forwarded to the webhook url by our servers.

Required range: x > 0
​
error
string

Error message if any error happened during the webhook request.