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

> Retrieve the list of addresses currently subscribed to a webhook.

Returns a paginated list of all wallet addresses that are currently subscribed to the specified webhook. This is useful for:

* Auditing which addresses are being monitored
* Verifying address subscriptions
* Exporting your subscription list

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

<Tip>
  If you're managing a large number of addresses (hundreds or thousands), use pagination to efficiently retrieve the complete list.
</Tip>


## OpenAPI

````yaml /openapi.json GET /beta/evm/subscriptions/webhooks/{webhookId}/addresses
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}/addresses:
    get:
      tags:
        - evm
        - subscriptions
      summary: Get webhook addresses
      description: Retrieves the list of subscribed addresses for a specific webhook.
      operationId: getWebhookAddresses
      parameters:
        - name: webhookId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: The unique identifier of the webhook.
        - 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.
      responses:
        '200':
          description: A list of addresses.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddressesList'
              example:
                addresses:
                  - '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
                  - '0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C'
        '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:
    AddressesList:
      type: object
      properties:
        addresses:
          type: array
          items:
            type: string
            description: EVM address.
        next_offset:
          type: string
          description: Cursor for pagination.
    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
  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.

````