> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sim.dune.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Webhook

> Retrieve detailed information about a specific webhook subscription.

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.


## OpenAPI

````yaml /openapi.json GET /beta/evm/subscriptions/webhooks/{webhookId}
openapi: 3.0.3
info:
  title: Sim API
  description: >-
    The Sim API by Dune provides real-time blockchain data across EVM and SVM
    chains. Access token balances, transaction history, on-chain activity, DeFi
    positions, NFT collectibles, token information, and webhook subscriptions
    through a unified REST API.
  version: 1.0.0
  license:
    name: ''
  contact:
    name: Dune Support
    url: https://docs.sim.dune.com
    email: support@dune.com
servers:
  - url: https://api.sim.dune.com
security:
  - ApiKeyAuth: []
tags:
  - name: evm
    description: EVM-compatible blockchain endpoints.
  - name: svm
    description: Solana/SVM blockchain endpoints.
  - name: activity
    description: On-chain activity feed.
  - name: balances
    description: Token balances (EVM and SVM).
  - name: transactions
    description: Transaction history (EVM and SVM).
  - name: collectibles
    description: NFT and ERC721/ERC1155 holdings.
  - name: defi
    description: DeFi protocol positions.
  - name: supported-chains
    description: Supported blockchain networks.
  - name: token-info
    description: Token metadata and pricing.
  - name: token-holders
    description: Token holder distribution.
  - name: subscriptions
    description: >-
      Webhook subscription management for real-time on-chain event
      notifications.
paths:
  /beta/evm/subscriptions/webhooks/{webhookId}:
    get:
      tags:
        - evm
        - subscriptions
      summary: Get a webhook
      description: Retrieves the details of a specific webhook subscription by its ID.
      operationId: getWebhook
      parameters:
        - name: webhookId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: The unique identifier of the webhook.
      responses:
        '200':
          description: Webhook details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Webhook'
              example:
                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
        '400':
          description: Invalid webhook ID.
          content:
            text/plain:
              schema:
                type: string
              example: >-
                Invalid URL: UUID parsing failed: invalid group length in group
                4: expected 12, found 11
        '429':
          description: Rate Limit Exceeded - Too many requests.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayErrorResponse'
              examples:
                rateLimitExceeded:
                  value:
                    error: >-
                      Too many requests. Please contact sales@dune.com to
                      increase your limit.
components:
  schemas:
    Webhook:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: The unique identifier for the webhook.
        team_id:
          type: string
          description: The team ID that owns this webhook.
        name:
          type: string
          description: A descriptive name for the webhook.
        type:
          $ref: '#/components/schemas/WebhookType'
        url:
          type: string
          format: uri
          description: The URL where webhook payloads will be sent.
        active:
          type: boolean
          description: Whether the webhook is currently active.
        created_at:
          type: string
          format: date-time
          description: When the webhook was created.
        updated_at:
          type: string
          format: date-time
          description: When the webhook was last updated.
        chain_ids:
          type: array
          items:
            type: integer
            format: int64
          nullable: true
          description: >-
            Filter events to specific chain IDs. If null, all supported chains
            are included.
        transaction_type:
          allOf:
            - $ref: '#/components/schemas/TransactionType'
          nullable: true
          description: For transaction webhooks, filter by sender or receiver.
          type: string
        counterparty:
          type: string
          nullable: true
          description: Filter transactions by counterparty address.
          example: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
        activity_type:
          allOf:
            - $ref: '#/components/schemas/ActivityType'
          nullable: true
          description: For activity webhooks, filter by specific activity type.
          type: string
        asset_type:
          allOf:
            - $ref: '#/components/schemas/AssetType'
          nullable: true
          description: Filter by asset type.
          type: string
        token_address:
          type: string
          nullable: true
          description: Filter events to a specific token address.
          example: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
    GatewayErrorResponse:
      type: object
      description: >-
        Error response from the API gateway. Returned for authentication,
        permissions, rate-limiting, and quota errors.
      properties:
        error:
          type: string
          description: Error message.
      required:
        - error
    WebhookType:
      type: string
      enum:
        - transactions
        - activities
        - balances
      description: The type of onchain event to subscribe to.
    TransactionType:
      type: string
      enum:
        - sender
        - receiver
      description: >-
        ONLY for 'transactions' type webhooks. Filter by whether the subscribed
        address is the sender or receiver. Cannot be used with 'balances' or
        'activities' webhook types.
    ActivityType:
      type: string
      enum:
        - approve
        - mint
        - burn
        - receive
        - send
        - swap
        - call
      description: >-
        ONLY for 'activities' type webhooks. Filter by specific activity types.
        Cannot be used with 'balances' or 'transactions' webhook types.
    AssetType:
      type: string
      enum:
        - native
        - erc20
        - erc721
        - erc1155
      description: Filter by asset type.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Sim-Api-Key
      description: >-
        API key for authentication. Obtain your key from the Dune dashboard at
        sim.dune.com.

````