Skip to content
Last updated
Edit

Command Reference

This page documents every command available in the Unstoppable Domains CLI. For installation and setup, see the CLI Quick Start.

Search & Discovery

Search for domain availability and pricing.

ud search <query>

Example:

ud search "mybusiness"
ud search "coffee.com"

ud tlds

List all available TLDs supported by the registrar.

ud tlds

Domain Management

ud domains list

List domains in your portfolio.

ud domains list

Key flags:

FlagDescription
--status <status>Filter by all, for-sale, or unlisted
--expiring-within <days>Show domains expiring within N days
--tag <tag>Filter by tag
--order-by <field>Sort by name, length, purchasedAt, expiresAt, listingPrice, offers, leads, watchlistCount
--order-direction <dir>asc or desc

Example:

ud domains list --status for-sale --order-by listingPrice
ud domains list --expiring-within 30
ud domains list --fields name,expiresAt,offersCount

ud domains get

Get detailed information about one or more domains.

ud domains get <domains...>

Example:

ud domains get example.com
ud domains get example.com mybrand.io

ud domains push

Push a domain to another user.

ud domains push <domains...>

ud domains auto-renewal update

Toggle auto-renewal for domains.

ud domains auto-renewal update <domains...>

ud domains tags

Manage domain tags.

ud domains tags add <domains...> --tag <tag>
ud domains tags remove <domains...> --tag <tag>

ud domains flags update

Update domain flags.

ud domains flags update <domains...>

DNS

ud domains dns records show

Display DNS records for a domain.

ud domains dns records show <domain>

Example:

ud domains dns records show example.com

ud domains dns records add

Add a DNS record.

ud domains dns records add <domain>

Pass record data inline with --data or from a file with --file:

ud domains dns records add example.com --data '{"type":"A","hostName":"@","value":"192.0.2.1","ttl":3600}'
ud domains dns records add example.com --file records.json

ud domains dns records update

Update an existing DNS record.

ud domains dns records update <domain>

ud domains dns records remove

Remove a DNS record.

ud domains dns records remove <domain>

ud domains dns records remove-all

Remove ALL user-created DNS records from one or more domains.

ud domains dns records remove-all <domains...>

This is destructive and cannot be undone. All user-created DNS records will be permanently deleted.

ud domains dns nameservers show

Display current nameservers.

ud domains dns nameservers show <domain>

ud domains dns nameservers set-custom

Set custom nameservers.

ud domains dns nameservers set-custom <domain>

ud domains dns nameservers set-default

Reset to UD default nameservers.

ud domains dns nameservers set-default <domain>

Using custom nameservers disables DNS record management through the CLI and API. Set default nameservers to re-enable it.

Hosting

ud domains hosting redirects show

Show redirect configurations for a domain.

ud domains hosting redirects show <domain>

ud domains hosting redirects add

Add a redirect configuration.

ud domains hosting redirects add

ud domains hosting redirects remove

Remove a redirect configuration.

ud domains hosting redirects remove

ud domains hosting landers generate

Generate an AI-powered landing page for one or more domains.

ud domains hosting landers generate <domains...>

ud domains hosting landers show

Show lander generation status for one or more domains.

ud domains hosting landers show <domains...>

ud domains hosting landers download

Download landing page content from one or more domains.

ud domains hosting landers download <domains...>

ud domains hosting landers remove

Remove an AI-generated landing page from one or more domains.

ud domains hosting landers remove <domains...>

Backorders & Expireds

ud marketplace expiring list

Browse the expireds/pending-delete domain marketplace.

ud marketplace expiring list

Key flags:

FlagDescription
--tlds <tlds>Filter by TLD extensions (comma-separated)
--status <status>COMING_SOON or AVAILABLE_BACKORDER
--sort-by <field>Sort field (default: deletionAt)
--sort-direction <dir>ASC or DESC
--query <term>Search by domain name or label substring
--length-range <min,max>Filter by label length range

Example:

ud marketplace expiring list --tlds com,net --status AVAILABLE_BACKORDER
ud marketplace expiring list --sort-by deletionAt --sort-direction ASC

ud domains backorders create

Create backorders for one or more expiring domains.

ud domains backorders create --name <domain> --contact-id <id> --available-after-timestamp <ts>

Required flags:

FlagDescription
--name <domain>Domain name to backorder
--contact-id <id>ICANN contact ID for domain registration
--available-after-timestamp <ts>Unix timestamp (ms) when the domain becomes available

The system monitors the domain and automatically registers it when it drops. An Account Balance hold is placed when the backorder is created.

ud domains backorders list

List your domain backorders.

ud domains backorders list

Key flags:

FlagDescription
--status <status>Filter by backorder status (e.g., pending, in-progress, completed-success)
--query <domain>Search by domain name (partial match)

ud domains backorders cancel

Cancel one or more pending backorders.

ud domains backorders cancel --backorder-ids <id1,id2,...>

Refunds the Account Balance hold (minus non-refundable service fee) and removes the scheduled registration job.

Cart & Checkout

ud cart list

View items in your shopping cart.

ud cart list

ud cart add

Add domains to your cart. Without a subcommand, ud cart add auto-detects the source type:

ud cart add <domains...>                # Smart add — auto-detects source
ud cart add registration <domains...>   # New domain registration
ud cart add renewal <domains...>        # Domain renewal
ud cart add listed <domains...>         # Marketplace listing
ud cart add afternic <domains...>       # Afternic listing
ud cart add sedo <domains...>           # Sedo listing

Example:

ud cart add mybusiness.com mybusiness.io  # Auto-detect
ud cart add registration mybusiness.com   # Explicit type
ud cart add listed premium.io

ud cart url

Get a checkout URL to complete the purchase in a browser.

ud cart url

ud cart remove

Remove items from the cart.

ud cart remove <domains...>

ud cart checkout

Complete the purchase.

ud cart checkout

ud cart payment-methods

Manage payment methods.

ud cart payment-methods

Marketplace

ud marketplace listings create

List domains for sale on the marketplace.

ud marketplace listings create <domains...>

ud marketplace listings update

Update existing marketplace listings.

ud marketplace listings update <domains...>

ud marketplace listings cancel

Remove domains from the marketplace.

ud marketplace listings cancel <domains...>

ud marketplace offers list

View incoming offers on your domains.

ud marketplace offers list

ud marketplace offers respond

Accept or decline an offer.

ud marketplace offers respond

ud marketplace leads list

View conversation leads for your domains.

ud marketplace leads list

ud marketplace leads open

Open a conversation lead.

ud marketplace leads open

ud marketplace leads messages list

List messages in a lead conversation.

ud marketplace leads messages list

ud marketplace leads messages send

Send a message in a lead conversation.

ud marketplace leads messages send

Contacts

ud domains contacts create

Create an ICANN contact for domain registration.

ud domains contacts create --data '{"firstName":"Jane","lastName":"Doe","email":"jane@example.com",...}'

ud domains contacts list

List your saved ICANN contacts.

ud domains contacts list

Configuration

ud config set

Save default options for a command.

ud config set "<command>" <key> <value>

Example:

ud config set "domains list" fields name,expiresAt
ud config set "domains list" format json

ud config get

View saved defaults.

ud config get [command]

ud config reset

Remove saved defaults.

ud config reset <command> [key]

ud env set

Switch the active environment.

ud env set <environment>

Example:

ud env set sandbox
ud env set production

ud env show

Display the current environment.

ud env show

Authentication

ud auth signup

Create a new Unstoppable Domains account. Prompts for email and password, sends a verification code, and signs you in automatically.

ud auth signup

Requires an interactive terminal. Password must be at least 8 characters with uppercase, lowercase, number, and special character.

ud auth login

Sign in to an existing Unstoppable Domains account.

ud auth login            # OAuth (opens browser)
ud auth login --key <key>  # API key

ud auth status

Check current authentication status.

ud auth status

ud auth logout

Clear stored credentials.

ud auth logout

Utilities

ud update

Update the CLI to the latest version.

ud update

ud update check

Check for available CLI updates without installing.

ud update check

ud completion

Generate shell completion scripts.

ud completion

ud install --skills

Install agent skills for Claude Code, Cursor, or GitHub Copilot.

ud install --skills

You can also install skills via npx:

npx skills add unstoppabledomains/ud-cli

Passing Complex Data

For commands that require structured input, use --data for inline JSON or --file to read from a file:

# Inline JSON
ud domains contacts create --data '{"firstName":"Jane","lastName":"Doe","email":"jane@example.com"}'

# From a file
ud domains dns records add example.com --file records.json