Get Webhook

Retrieve detailed information about a specific webhook subscription.

GET /beta/evm/subscriptions/webhooks/{webhookId}

Get a webhook

cURL

curl --request GET \
  --url https://api.sim.dune.com/beta/evm/subscriptions/webhooks/{webhookId} \
  --header 'X-Sim-Api-Key: <x-sim-api-key>'

200

{
  "id": "019a81c2-d84b-7141-85e8-86b072a59142",
  "team_id": "01K7RVMRT0BXQ9DRC8BK87MK39",
  "name": "Balance Changes Tracker",
  "type": "balances",
  "url": "https://example.com/webhooks/balances",
  "active": true,
  "created_at": "2025-11-14T09:47:01.580104Z",
  "updated_at": "2025-11-14T09:47:01.580104Z",
  "chain_ids": [
    1,
    8453,
    84532
  ]
}

Retrieves the complete configuration and metadata for a specific webhook subscription. Use this endpoint to:

• Check the current status of a webhook
• View the webhook’s configuration and filters
• Verify when a webhook was created or last updated

The response includes all webhook properties, including optional filters that may have been set during creation.

Headers

X-Sim-Api-Key · string · required

Used for authenticating requests. Visit Authentication to learn how to create your API key.

Path Parameters

webhookId · string<uuid> · required

The unique identifier of the webhook.

Response

200

application/json

Webhook details.

id · string<uuid>

The unique identifier for the webhook.

team_id · string

The team ID that owns this webhook.

name · string

A descriptive name for the webhook.

type · enum<string>

The type of onchain event to subscribe to.

Available options: transactions, activities, balances

url · string<uri>

The URL where webhook payloads will be sent.

active · boolean

Whether the webhook is currently active.

created_at · string<date-time>

When the webhook was created.

updated_at · string<date-time>

When the webhook was last updated.

chain_ids · integer<int64>[] | null

Filter events to specific chain IDs. If null, all supported chains are included.

transaction_type · enum<string> | null

For transaction webhooks, filter by sender or receiver.

Available options: sender, receiver

counterparty · string | null

Filter transactions by counterparty address.

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

activity_type · enum<string> | null

For activity webhooks, filter by specific activity type.

Available options: approve, mint, burn, receive, send, swap, call

asset_type · enum<string> | null

Filter by asset type.

Available options: native, erc20, erc721, erc1155

token_address · string | null

Filter events to a specific token address.

Example:

"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"