---
title: "Get comprehensive portfolio domain info"
method: POST
path: "/mcp/v1/actions/ud_domain_get"
tags: ["Portfolio"]
---

# Get comprehensive portfolio domain info

`POST /mcp/v1/actions/ud_domain_get`

Get comprehensive information for specific domains in your portfolio. Returns all data from ud_portfolio_list plus additional detail: renewal pricing, flags, DNS configuration (nameservers, hosting, DNSSEC), marketplace metrics, and pending operations. Supports bulk lookups for up to 50 domains.

## Request body

- object
  - `domains` string[], required — Array of domain names to get info for (e.g., ["example.com", "mysite.io"])

## Response `200`

Portfolio domain details

- GetPortfolioDomainsResponse
  - `domains` object[] — Comprehensive info for each requested domain
    - `domain` string — The domain name
    - `found` boolean — Whether the domain was found in your portfolio
    - `extension` string — TLD (e.g., "com")
    - `label` string — Domain label without TLD
    - `sld` string, nullable — Second-level domain
    - `punycode` boolean — Whether domain uses punycode encoding
    - `lifecycle` object — Domain lifecycle: dates, ownership, renewal, auto-renewal
      - `purchasedAt` string, nullable — Purchase date (ISO 8601)
      - `expiresAt` string, nullable — Expiration date (ISO 8601)
      - `transferStatus` string — Transfer status: "none" or "pending"
      - `isExternallyOwned` boolean — Whether domain is in registrar custody (externally owned)
      - `reverse` boolean — Whether reverse resolution is enabled
      - `renewal` object, nullable — Renewal eligibility and pricing
        - `isEligible` boolean — Whether domain is eligible for renewal
        - `period` object
          - `min` number — Minimum renewal years
          - `max` number — Maximum renewal years
          - `increments` number — Renewal year increments
        - `pricePerYear` number — Renewal price per year in cents (USD)
        - `pricePerYearFormatted` string — Formatted price (e.g., "$12.99")
      - `autoRenewal` object, nullable — Auto-renewal subscription status
        - `status` string — Subscription status
        - `expiresAt` string, nullable — Next renewal date (ISO 8601)
    - `flags` object, nullable — Domain-level flags (WHOIS privacy, transfer lock, etc.)
      - `DNS_TRANSFER_OUT` object — Transfer lock status
        - `status` 'ENABLED' | 'DISABLED'
      - `DNS_WHOIS_PROXY` object — WHOIS privacy status
        - `status` 'ENABLED' | 'DISABLED'
      - `DNS_RESOLUTION` object
        - `status` 'ENABLED' | 'DISABLED'
      - `DNS_DELETE` object
        - `status` 'ENABLED' | 'DISABLED'
      - `DNS_UPDATE` object
        - `status` 'ENABLED' | 'DISABLED'
      - `DNS_UNS_TOKENIZATION` object
        - `status` 'ENABLED' | 'DISABLED'
    - `dns` object — DNS configuration from cache (nameservers, hosting, DNSSEC)
      - `nameservers` object, nullable
        - `status` 'default' | 'custom' | 'none' — Nameserver status: default (UD-managed), custom (external), none
        - `nameservers` string[] — Nameserver hostnames
      - `hosting` object[], nullable — URL redirects and hosting rules
        - `subName` string — Subdomain name
        - `type` string — Hosting type (REDIRECT_301, REDIRECT_302, UD_PROFILE)
        - `targetUrl` string, nullable — Target URL for redirect
        - `status` string — Hosting status (ACTIVE, INACTIVE, PENDING)
      - `dnssec` object, nullable
        - `enabled` boolean — Whether DNSSEC is enabled
        - `valid` boolean — Whether DNSSEC validation passes
    - `marketplace` object — Marketplace listing and engagement metrics
      - `listing` object, nullable — Active listing details
        - `id` number
        - `price` number — Listing price in cents
        - `status` string
        - `createdAt` string
        - `updatedAt` string
        - `views` number
        - `listingSettings` object, nullable
      - `offersCount` number — Number of active offers
      - `leadsCount` number — Number of buyer leads
      - `watchlistCount` number — Number of users watching this domain
    - `tags` string[] — Tags applied to this domain
    - `pendingOperations` object[] — Pending DNS/domain operations
      - `id` string
      - `type` string
      - `status` string
      - `createdAt` string
    - `error` string — Error message if retrieval failed
  - `availableTags` string[] — All tags you've created (useful for adding tags to other domains)

## Other responses

- `401` — Authentication required

---

[API](https://skmtc.net/unstoppabledomains/apis/user-api.md) · [All operations](https://skmtc.net/unstoppabledomains/apis/user-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstoppabledomains/user-api/versions/c1def8e34b41/schema)