Unstoppable Domains User API

{"openapi":"3.1.0","info":{"title":"User API","description":"Search, check availability, and purchase traditional DNS domains. This API enables AI assistants to help users find and buy domain names.\n\nWhen using the API directly, you will need an API key. See [API Key setup](/user-api/overview#api-key-advanced) for instructions.","version":"1.0.0","contact":{"name":"Unstoppable Domains","url":"https://unstoppabledomains.com","email":"[email protected]"},"x-logo":{"url":"https://unstoppabledomains.com/images/logos/ud-logo-icon.svg"}},"servers":[{"url":"https://api.unstoppabledomains.com","description":"Production server"}],"paths":{"/mcp/v1/actions/ud_domains_search":{"post":{"operationId":"domainsSearch","summary":"Search for available domains or check specific domain availability","description":"Search for domain availability and pricing. Can check a specific domain (e.g., \"example.com\") or search terms across multiple TLDs. Supports multiple queries in a single request for efficient batch lookups. Returns a list of matching domains with their availability status, prices, and other details. IMPORTANT: Not all ICANN TLDs are supported. Use ud_tld_list to verify TLD support before searching with specific TLDs.","tags":["Domain Search"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"oneOf":[{"type":"string","minLength":1},{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":10}],"description":"Domain name(s) to search - can be a full domain name like \"example.com\" (TLD is inferred) or a search term like \"mybusiness\" (searches across TLDs). Supports array of up to 10 terms for batch operations.","example":"example.com"},"tlds":{"type":"array","items":{"type":"string"},"description":"Optional list of up to 5 ICANN TLDs to search (e.g., [\"com\", \"org\", \"io\"]). Must be supported TLDs - use ud_tld_list to verify. Defaults to popular TLDs (com, net, org, ai, io) or inferred from query.","example":["com","org","io"]},"limit":{"type":"number","minimum":1,"maximum":100,"description":"Maximum number of results to return (1-100, default: 20)","example":20},"offset":{"type":"number","minimum":0,"description":"Number of results to skip for pagination (default: 0)","example":0}}}}}},"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchDomainsResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_tld_list":{"post":{"operationId":"tldList","summary":"List available TLDs","description":"List all available ICANN TLDs (top-level domains) supported by our registrar.","tags":["Domain Search"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"List of available TLDs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TldListResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_portfolio_list":{"post":{"operationId":"portfolioList","summary":"List portfolio domains","description":"List domains in the authenticated user's portfolio with filtering, sorting, and pagination. By default, only ICANN (DNS) domains are returned. Returns 50 domains per page by default. If hasMore is true in the pagination response, increment the page parameter to fetch additional results.","tags":["Portfolio"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"number","minimum":1,"description":"Page number, 1-indexed (default: 1)","example":1},"pageSize":{"type":"number","minimum":1,"maximum":100,"description":"Number of domains per page, 1-100 (default: 50)","example":50},"searchTerm":{"type":"string","description":"Optional search term to filter domains by name"},"status":{"type":"string","enum":["all","for-sale","unlisted"],"description":"Filter by listing status: \"all\" (default), \"for-sale\", or \"unlisted\""},"registryType":{"type":"string","enum":["dns","web3"],"description":"Filter by registry type: \"dns\" (ICANN/Web2 domains, default) or \"web3\" (blockchain domains only)"},"expiringWithinDays":{"type":"number","minimum":1,"maximum":365,"description":"Filter domains expiring within the specified number of days (1-365)","example":30},"expired":{"type":"boolean","description":"Filter for domains that have already expired"},"minLength":{"type":"number","minimum":1,"description":"Filter domains with label length >= this value"},"maxLength":{"type":"number","minimum":1,"description":"Filter domains with label length <= this value"},"autoRenewal":{"type":"string","enum":["true","false"],"description":"Filter by auto-renewal status"},"tagFilters":{"type":"array","items":{"type":"string"},"description":"Filter domains by tag names (e.g., [\"personal\", \"business\"])"},"orderBy":{"type":"string","enum":["name","length","purchasedAt","expiresAt","listingPrice","offers","leads","watchlistCount"],"description":"Sort by: \"name\", \"length\", \"purchasedAt\", \"expiresAt\", \"listingPrice\", \"offers\", \"leads\", or \"watchlistCount\""},"orderDirection":{"type":"string","enum":["asc","desc"],"description":"Sort direction: \"asc\" (ascending, default) or \"desc\" (descending)"}}}}}},"responses":{"200":{"description":"Portfolio domains list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListDomainsResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_domain_get":{"post":{"operationId":"domainGet","summary":"Get comprehensive portfolio domain info","description":"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.","tags":["Portfolio"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domains"],"properties":{"domains":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":50,"description":"Array of domain names to get info for (e.g., [\"example.com\", \"mysite.io\"])","example":["example.com","mysite.io"]}}}}}},"responses":{"200":{"description":"Portfolio domain details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPortfolioDomainsResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_contacts_list":{"post":{"operationId":"contactsList","summary":"List ICANN contacts","description":"List ICANN contacts configured for the authenticated user's account. Required for DNS domain registration (.com, .org, etc.).","tags":["Contacts"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"includeDisabled":{"type":"boolean","description":"Include disabled contacts (default: false)"}}}}}},"responses":{"200":{"description":"List of ICANN contacts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactsListResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_contact_create":{"post":{"operationId":"contactCreate","summary":"Create ICANN contact","description":"Create a new ICANN contact for DNS domain registration. Required for .com, .org, .net, etc.","tags":["Contacts"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["firstName","lastName","email","phone","street","city","stateProvince","postalCode","countryCode"],"properties":{"firstName":{"type":"string","description":"Contact first name"},"lastName":{"type":"string","description":"Contact last name"},"email":{"type":"string","format":"email","description":"Contact email address"},"phone":{"type":"object","required":["dialingPrefix","number"],"properties":{"dialingPrefix":{"type":"string","description":"Phone country code (e.g., \"1\")"},"number":{"type":"string","description":"Phone number"}}},"street":{"type":"string","description":"Street address"},"city":{"type":"string","description":"City"},"stateProvince":{"type":"string","description":"State/province code"},"postalCode":{"type":"string","description":"Postal/ZIP code"},"countryCode":{"type":"string","description":"Two-letter ISO country code"},"organization":{"type":"string","description":"Company name (optional)"}}}}}},"responses":{"200":{"description":"Contact created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactCreateResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_cart_get":{"post":{"operationId":"cartGet","summary":"Get shopping cart with pricing","description":"Get the current shopping cart contents with comprehensive pricing breakdown including discounts, taxes, and credits. Optionally apply a discount code. Requires authentication.","tags":["Cart"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"discountCode":{"type":"string","description":"Optional discount/promo code to apply"}}}}}},"responses":{"200":{"description":"Cart contents with pricing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CartResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_cart_add_domain_registration":{"post":{"operationId":"cartAddDomainRegistration","summary":"Add domains to cart for registration","description":"Add one or more domains to the shopping cart for fresh registration. Returns the updated cart summary. Requires authentication.","tags":["Cart"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domains"],"properties":{"domains":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Full domain name (e.g., \"example.com\")"},"productType":{"type":"string","description":"Product type (default: Domain)"},"quantity":{"type":"integer","description":"Registration years (1-10, default: 1)","minimum":1,"maximum":10}}},"minItems":1,"description":"Array of domains to add to the cart"}}}}}},"responses":{"200":{"description":"Updated cart","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddToCartResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_cart_add_domain_listed":{"post":{"operationId":"cartAddDomainListed","summary":"Add marketplace-listed domains to cart","description":"Add one or more marketplace-listed domains to the shopping cart. Supports both \"Buy it now\" (full price) and \"Lease to Own\" (monthly payments) purchases. Requires authentication.","tags":["Cart"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domains"],"properties":{"domains":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Full domain name listed on marketplace (e.g., \"premium.com\")"},"leaseToOwnOptions":{"type":"object","description":"Optional lease-to-own options. Omit for immediate \"Buy it now\" purchase.","properties":{"type":{"type":"string","enum":["equal_installments","down_payment_plus_equal_installments"],"description":"Payment type: \"equal_installments\" or \"down_payment_plus_equal_installments\""},"termLength":{"type":"integer","minimum":2,"maximum":120,"description":"Number of monthly payments (2-120)"},"downPaymentPercentage":{"type":"number","minimum":10,"maximum":90,"description":"Down payment percentage (10-90%), required for down_payment type"}}}}},"minItems":1,"maxItems":50,"description":"Array of marketplace-listed domains to add to cart"}}}}}},"responses":{"200":{"description":"Updated cart with listed domains","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddListedDomainToCartResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_cart_add_domain_afternic":{"post":{"operationId":"cartAddDomainAfternic","summary":"Add Afternic marketplace domains to cart","description":"Add one or more Afternic marketplace domains to the shopping cart. For domains with marketplace.source = \"afternic\" and marketplace.status = \"registered-listed-for-sale\" from search results. Requires authentication.","tags":["Cart"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domains"],"properties":{"domains":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Full domain name from Afternic marketplace (e.g., \"premium.com\")"}}},"minItems":1,"maxItems":50,"description":"Array of Afternic marketplace domains to add to cart"}}}}}},"responses":{"200":{"description":"Updated cart with Afternic domains","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddAfternicDomainToCartResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_cart_add_domain_sedo":{"post":{"operationId":"cartAddDomainSedo","summary":"Add Sedo marketplace domains to cart","description":"Add one or more Sedo marketplace domains to the shopping cart. For domains with marketplace.source = \"sedo\" and marketplace.status = \"registered-listed-for-sale\" from search results. Requires authentication.","tags":["Cart"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domains"],"properties":{"domains":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Full domain name from Sedo marketplace (e.g., \"premium.com\")"}}},"minItems":1,"maxItems":50,"description":"Array of Sedo marketplace domains to add to cart"}}}}}},"responses":{"200":{"description":"Updated cart with Sedo domains","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddSedoDomainToCartResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_cart_add_domain_renewal":{"post":{"operationId":"cartAddDomainRenewal","summary":"Add domain renewals to cart","description":"Add one or more domain renewals to the shopping cart. User must own the domains to renew them. Returns the updated cart summary. Requires authentication.","tags":["Cart"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domains"],"properties":{"domains":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Full domain name to renew (e.g., \"example.com\")"},"quantity":{"type":"integer","description":"Renewal period in years (1-10, default: 1)","minimum":1,"maximum":10}}},"minItems":1,"maxItems":50,"description":"Array of domains to add renewal to cart"}}}}}},"responses":{"200":{"description":"Updated cart with renewals","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddDomainRenewalToCartResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_cart_remove":{"post":{"operationId":"cartRemove","summary":"Remove items from cart","description":"Remove one or more items from the shopping cart by product ID. Returns the updated cart. Requires authentication.","tags":["Cart"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["productIds"],"properties":{"productIds":{"type":"array","items":{"type":"number"},"minItems":1,"description":"Array of product IDs to remove from the cart"}}}}}},"responses":{"200":{"description":"Updated cart","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoveFromCartResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_cart_get_payment_methods":{"post":{"operationId":"cartGetPaymentMethods","summary":"Get available payment methods","description":"Get saved credit cards, account balance, and promo credits available for checkout. Requires authentication.","tags":["Cart"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Payment methods","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentMethodsResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_cart_add_payment_method_url":{"post":{"operationId":"cartAddPaymentMethodUrl","summary":"Get URL to add a payment method","description":"Get a URL to the payment management page where users can securely add a new credit card. Requires authentication.","tags":["Cart"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Add payment method URL","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddPaymentMethodUrlResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_cart_checkout":{"post":{"operationId":"cartCheckout","summary":"Complete cart checkout","description":"Complete checkout for cart items using saved payment method or account balance. Requires authentication.","tags":["Cart"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"paymentMethodId":{"type":"string","description":"Stripe payment method ID for card payment. Required if cart total exceeds account balance."},"useAccountBalance":{"type":"boolean","description":"Whether to apply account balance to reduce total. Defaults to true."},"discountCode":{"type":"string","description":"Optional discount/promo code to apply"},"contactId":{"type":"string","description":"ICANN contact ID for DNS domain registration. Get IDs from ud_contacts_list. If not specified, uses the most recent contact."}}}}}},"responses":{"200":{"description":"Checkout result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_cart_get_url":{"post":{"operationId":"cartGetUrl","summary":"Get checkout URL","description":"Generate a checkout URL for completing the purchase in a browser. Returns the URL along with a cart summary. Requires authentication.","tags":["Cart"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"discountCode":{"type":"string","description":"Optional discount/promo code to include in checkout URL"}}}}}},"responses":{"200":{"description":"Checkout URL and cart summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutUrlResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_listing_create":{"post":{"operationId":"listingCreate","summary":"Create marketplace listings","description":"List one or more domains for sale on the marketplace. Supports buy-now pricing, offers, and lease-to-own options.","tags":["Marketplace"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domains"],"properties":{"domains":{"type":"array","items":{"type":"object","required":["domainName"],"properties":{"domainName":{"type":"string","description":"The domain name to list"},"priceInCents":{"type":"number","description":"Buy-now price in cents (0 for offers-only)"},"expiresAt":{"type":"string","description":"Listing expiration date as ISO 8601 string (e.g., \"2025-12-31\"). Must be 1-36500 days from now. Default: 90 days."},"isEmailAliasUsed":{"type":"boolean","description":"Enable message seller feature"},"listingSettings":{"type":"object","properties":{"isOfferFeatureEnabled":{"type":"boolean"},"minOfferAmountInCents":{"type":"number"},"domainDisplayName":{"type":"string","description":"Optional human-readable domain display name used in listings"}}},"leaseToOwnOptions":{"type":"object","description":"Optional lease-to-own configuration for the domain listing","properties":{"type":{"type":"string","enum":["equal_installments","down_payment_plus_equal_installments"]},"maxTermLength":{"type":"integer","minimum":2,"maximum":120,"description":"Maximum term length in months (2-120)"},"downPaymentPercentage":{"type":"number","description":"Down payment percentage (10-90), required for down_payment type"}}}}},"minItems":1,"maxItems":50}}}}}},"responses":{"200":{"description":"Listing creation results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateListingResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_listing_update":{"post":{"operationId":"listingUpdate","summary":"Update marketplace listings","description":"Update price, settings, or options for existing listings.","tags":["Marketplace"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["listings"],"properties":{"listings":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"number","description":"Listing ID"},"priceInCents":{"type":"number"},"expiresAt":{"type":"string","description":"New listing expiration date as ISO 8601 string (e.g., \"2025-12-31\"). Must be 1-36500 days from now."},"isEmailAliasUsed":{"type":"boolean"},"listingSettings":{"type":"object","description":"Listing-level settings such as offers and display preferences.","properties":{"minOfferAmountInCents":{"type":"number","description":"Minimum offer amount (in cents) accepted for this listing."},"isOfferFeatureEnabled":{"type":"boolean","description":"Indicates whether the offer feature is enabled for this listing."},"domainDisplayName":{"type":"string","description":"Custom display name to use for this domain in marketplace contexts."}}},"leaseToOwnOptions":{"type":"object","description":"Lease-to-own configuration options for the listing.","properties":{"type":{"type":"string","enum":["equal_installments","down_payment_plus_equal_installments"]},"maxTermLength":{"type":"integer","minimum":2,"maximum":120,"description":"Maximum term length in months (2-120)"},"downPaymentPercentage":{"type":"number","description":"Down payment percentage (10-90), required for down_payment type"}}}}},"minItems":1,"maxItems":50}}}}}},"responses":{"200":{"description":"Listing update results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateListingResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_listing_cancel":{"post":{"operationId":"listingCancel","summary":"Cancel marketplace listings","description":"Cancel one or more active marketplace listings.","tags":["Marketplace"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["listingIds"],"properties":{"listingIds":{"type":"array","items":{"type":"number"},"description":"Array of listing IDs to cancel","minItems":1,"maxItems":50}}}}}},"responses":{"200":{"description":"Cancellation results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelListingResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_offers_list":{"post":{"operationId":"offersList","summary":"List marketplace offers","description":"List incoming offers on domains you own. Filter by domain or status.","tags":["Marketplace"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domainName":{"type":"string","description":"Filter by specific domain name"},"group":{"type":"string","enum":["active","sold"],"description":"Filter by group: \"active\" (pending) or \"sold\" (completed)"},"page":{"type":"number","description":"Page number (1-indexed)"}}}}}},"responses":{"200":{"description":"List of offers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListOffersResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_offer_respond":{"post":{"operationId":"offerRespond","summary":"Respond to marketplace offers","description":"Accept or reject incoming offers on your domains.","tags":["Marketplace"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["offers"],"properties":{"offers":{"type":"array","items":{"type":"object","required":["id","action"],"properties":{"id":{"type":"number","description":"Offer ID"},"action":{"type":"string","enum":["accept","reject"]}}},"minItems":1,"maxItems":50}}}}}},"responses":{"200":{"description":"Offer response results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespondToOfferResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_leads_list":{"post":{"operationId":"leadsList","summary":"List domain conversation leads","description":"List conversations about domains you own or are interested in. Includes buyer-seller messaging threads.","tags":["Leads"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"Filter by specific domain name (e.g., \"example.crypto\")"},"skipEmpty":{"type":"boolean","description":"Skip conversations with no messages (default: true)","default":true},"skip":{"type":"integer","description":"Number of conversations to skip (pagination offset, default: 0)","default":0,"minimum":0},"take":{"type":"integer","description":"Number of conversations to return (1-100, default: 20)","default":20,"minimum":1,"maximum":100}}}}}},"responses":{"200":{"description":"List of conversations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadsListResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_lead_get":{"post":{"operationId":"leadGet","summary":"Get or create domain conversation","description":"Start or find an existing conversation with the seller of a domain. Returns existing conversation if one already exists.","tags":["Leads"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"The domain name to inquire about (e.g., \"example.crypto\")"},"buyerId":{"type":"string","description":"Optional: Encoded buyer ID for sellers responding to offers"}}}}}},"responses":{"200":{"description":"Conversation details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactSellerResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_lead_messages_list":{"post":{"operationId":"leadMessagesList","summary":"List messages in a conversation","description":"Get messages in a domain conversation. Messages are returned newest-first with cursor-based pagination.","tags":["Leads"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["conversationId"],"properties":{"conversationId":{"type":"number","description":"The conversation ID"},"cursor":{"type":"string","description":"Pagination cursor for loading older messages"}}}}}},"responses":{"200":{"description":"List of messages","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadMessagesListResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_lead_message_send":{"post":{"operationId":"leadMessageSend","summary":"Send a message in a conversation","description":"Send a message in a domain conversation. Messages are encrypted at rest.","tags":["Leads"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["conversationId","content"],"properties":{"conversationId":{"type":"number","description":"The conversation ID"},"content":{"type":"string","maxLength":1000,"description":"Message content (1-1000 characters)"}}}}}},"responses":{"200":{"description":"Sent message details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadMessageSendResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_dns_records_list":{"post":{"operationId":"dnsRecordsList","summary":"List DNS records for a domain","description":"List all DNS records for a domain in your portfolio. Supports filtering by record type and subdomain, with pagination.","tags":["DNS Management"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"Domain name (e.g., \"example.com\")"},"type":{"type":"string","description":"Filter by record type (A, AAAA, CNAME, MX, TXT, NS)"},"subName":{"type":"string","description":"Filter by subdomain (\"@\" for root, \"www\", \"*\" for wildcard)"},"cursor":{"type":"string","description":"Pagination cursor"}}}}}},"responses":{"200":{"description":"DNS records list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DnsRecordsListResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_dns_record_add":{"post":{"operationId":"dnsRecordAdd","summary":"Add DNS records (bulk)","description":"Add DNS records to one or more domains. Supports A, AAAA, CNAME, MX, TXT, NS, SRV, and CAA record types. Bulk operations up to 50 records.","tags":["DNS Management"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["records"],"properties":{"records":{"type":"array","minItems":1,"maxItems":50,"description":"Array of DNS record configurations (1-50)","items":{"type":"object","required":["domain","type","values"],"properties":{"domain":{"type":"string","description":"Domain name (e.g., \"example.com\")"},"type":{"type":"string","description":"Record type (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)"},"subName":{"type":"string","default":"@","description":"Subdomain (\"@\" for root, \"www\", \"*\" for wildcard)"},"values":{"type":"array","items":{"type":"string"},"description":"Record values"},"ttl":{"type":"number","default":3600,"description":"Time-to-live in seconds (60-86400)"}}}},"upsertMode":{"type":"string","enum":["append","replace","disallowed"],"description":"Global setting for how to handle existing records"}}}}}},"responses":{"200":{"description":"Bulk operation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDnsOperationResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_dns_record_update":{"post":{"operationId":"dnsRecordUpdate","summary":"Update DNS records (bulk)","description":"Update existing DNS records on one or more domains. Bulk operations up to 50 records.","tags":["DNS Management"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["records"],"properties":{"records":{"type":"array","minItems":1,"maxItems":50,"description":"Array of record update configurations (1-50)","items":{"type":"object","required":["domain","recordId","values"],"properties":{"domain":{"type":"string","description":"Domain name"},"recordId":{"type":"string","description":"Record ID from ud_dns_records_list"},"values":{"type":"array","items":{"type":"string"},"description":"New record values"},"ttl":{"type":"number","default":3600,"description":"Time-to-live in seconds (60-86400). Default: 3600"}}}}}}}}},"responses":{"200":{"description":"Bulk operation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDnsOperationResponse"}}}},"401":{"description":"Authentication required"}}}},"/mcp/v1/actions/ud_dns_record_remove":{"post":{"operationId":"dnsRecordRemove","summary":"Remove DNS records (bulk)","description":"Remove specific DNS records by ID from one or more domains. Bulk operations up 

# --- truncated at 32 KB (99 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/unstoppable-domains/refs/heads/main/openapi/unstoppable-domains-user-api-openapi.json