> ## 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.

# List Webhooks

> Retrieve a paginated list of all webhook subscriptions for your team.

Returns a list of all webhook subscriptions associated with your authenticated team. Use this endpoint to view all your active and inactive webhooks, along with their configurations.

## Pagination

This endpoint uses cursor-based pagination. Use the `limit` parameter to control page size, and pass the `next_offset` value from the response as the `offset` parameter to retrieve the next page.


## OpenAPI

````yaml /openapi.json GET /beta/evm/subscriptions/webhooks
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:
    get:
      tags:
        - evm
        - subscriptions
      summary: List all webhooks
      description: Returns a list of all webhook subscriptions for the authenticated team.
      operationId: listWebhooks
      parameters:
        - in: query
          name: limit
          schema:
            type: integer
            default: 100
          description: Number of results to return. Defaults to 100.
        - in: query
          name: offset
          schema:
            type: string
          description: >-
            The offset to paginate through result sets; this is a cursor being
            passed from the previous response.
      responses:
        '200':
          description: A list of webhooks.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhooksList'
              example:
                webhooks:
                  - id: 019a81c2-d84b-7141-85e8-86b072a59142
                    team_id: 01K7RVMRT0BXQ9DRC8BK87MK39
                    name: Balance Changes Monitor
                    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
                    asset_type: erc20
                    token_address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                  - id: 019a81c2-e95c-7241-95f9-97c183b6a253
                    team_id: 01K7RVMRT0BXQ9DRC8BK87MK39
                    name: Swap Activity Tracker
                    type: activities
                    url: https://example.com/webhooks/activities
                    active: true
                    created_at: '2025-11-14T10:15:22.123456Z'
                    updated_at: '2025-11-14T10:15:22.123456Z'
                    chain_ids:
                      - 1
                      - 8453
                    activity_type: swap
                  - id: 019a81c2-f86d-7351-a6fa-a8d294c7b364
                    team_id: 01K7RVMRT0BXQ9DRC8BK87MK39
                    name: Incoming Transactions Monitor
                    type: transactions
                    url: https://example.com/webhooks/transactions
                    active: true
                    created_at: '2025-11-14T10:30:45.789012Z'
                    updated_at: '2025-11-14T10:30:45.789012Z'
                    chain_ids:
                      - 1
                    transaction_type: receiver
        '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:
    WebhooksList:
      type: object
      properties:
        webhooks:
          type: array
          items:
            $ref: '#/components/schemas/Webhook'
        next_offset:
          type: string
          description: >-
            Cursor for pagination. Pass this value as the offset parameter to
            get the next page.
    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
    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'
    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.

````