Skip to main content
GET
/
beta
/
evm
/
subscriptions
/
webhooks
/
{webhookId}
Get a webhook
curl --request GET \
  --url https://api.sim.dune.com/beta/evm/subscriptions/webhooks/{webhookId} \
  --header 'X-Sim-Api-Key: <x-sim-api-key>'
{
  "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. Provide an API key with a purpose of Sim API. See Authentication.

Path Parameters

​
webhookId
string<uuid>
required

The unique identifier of the webhook.

Response

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[] | null

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

​
transaction_type
enum<string>

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>

For activity webhooks, filter by specific activity type.

Available options:
approve,
mint,
burn,
receive,
send,
swap,
call
​
asset_type
enum<string>

Filter by asset type.

Available options:
native,
erc20,
erc721,
erc1155
​
token_address
string | null

Filter events to a specific token address.

Example:

"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"