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

# List external addresses

> Retrieve a list of external addresses configured for informational webhook notifications
in your environment. External addresses are blockchain addresses not generated by
Portal that you still want to monitor for transactions.




## OpenAPI

````yaml /openapi/custodian-api.yaml get /custodians/me/alerts/webhooks/external-addresses
openapi: 3.1.0
info:
  title: Portal Custodian API
  version: '3.0'
  description: >
    The Portal Custodian API provides endpoints for managing clients, building
    transactions,

    retrieving wallet data, managing delegations, informational webhooks and gas
    sponsorship, and

    reading the Portal Dashboard audit log.

    All endpoints require authentication via a Portal API Key (also known as a
    Custodian API Key)

    passed as a Bearer token.


    ## Base URL

    `https://api.portalhq.io/api/v3`


    ## Authentication

    Include your Portal API Key as a Bearer token in the `Authorization` header
    of every request.


    ## Chain ID Format

    Chain parameters use either friendly names (e.g. `ethereum`, `solana`) or
    CAIP-2 format

    (e.g. `eip155:1`, `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`). When using
    CAIP-2 format

    in URLs, ensure the colon is URI-encoded (`%3A`).
servers:
  - url: https://api.portalhq.io/api/v3
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Clients
    description: Create and manage Portal clients
  - name: Transactions
    description: Build and evaluate blockchain transactions
  - name: Wallet Metadata
    description: Retrieve wallet balances and NFTs
  - name: Wallet Shares
    description: Manage backup shares and wallet ejection
  - name: Delegations
    description: Manage token delegations and delegated transfers
  - name: Session Keys
    description: Build and send EIP-7702 session key user operations
  - name: Informational Webhooks
    description: >-
      Manage informational webhooks, external addresses, and resend failed
      events
  - name: Gas Sponsorship
    description: View and manage gas sponsorship across chains
  - name: Due
    description: Manage Due webhook endpoints and deliveries
  - name: Audit Events
    description: Read the audit log of actions taken in the Portal Dashboard
paths:
  /custodians/me/alerts/webhooks/external-addresses:
    get:
      tags:
        - Informational Webhooks
      summary: List external addresses
      description: >
        Retrieve a list of external addresses configured for informational
        webhook notifications

        in your environment. External addresses are blockchain addresses not
        generated by

        Portal that you still want to monitor for transactions.
      operationId: listExternalAddresses
      responses:
        '200':
          description: External addresses retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalAddressListResponse'
              example:
                data:
                  - id: cm4voycw2001f68veade3tr0i
                    address: '0x1234567890abcdef1234567890abcdef12345678'
                    namespace: EIP155
                    createdAt: '2025-01-15T10:30:00.000Z'
                    updatedAt: '2025-01-15T10:30:00.000Z'
                  - id: cm4voycw2001f68veade3tr0j
                    address: ABC123def456...
                    namespace: SOLANA
                    createdAt: '2025-01-16T14:00:00.000Z'
                    updatedAt: '2025-01-16T14:00:00.000Z'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - invalid or missing authentication token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ExternalAddressListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/ExternalAddress'
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Error message describing what went wrong
    ExternalAddress:
      type: object
      properties:
        id:
          type: string
        address:
          type: string
          description: The blockchain address being monitored.
        namespace:
          type: string
          enum:
            - eip155
            - solana
          description: The blockchain namespace of the address.
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: |
        Portal API Key (Custodian API Key). Pass as a Bearer token in the
        Authorization header.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.