Name.com

Name.com domain registrar - domain search/register/renew, DNS CRUD, nameservers, contacts, and transfers via REST API.

Origin: Forma CLI (wraps Name.com REST API) - www.name.com/api-docs

Install

pip install forma-namecom

Quick Start

export NAMECOM_TOKEN=username:token

# Search for a domain
namecom domains search --keyword myproject

# List your domains
namecom domains list

# List DNS records
namecom dns list --domain example.com

Key Commands

# Domains
namecom domains list
namecom domains search --keyword myproject
namecom domains get --domain example.com
namecom domains purchase --domain example.com
namecom domains renew --domain example.com --years 1

# DNS Records
namecom dns list --domain example.com
namecom dns create --domain example.com --type A --host "" --answer "1.2.3.4" --ttl 300
namecom dns update --domain example.com --id <id> --answer "5.6.7.8"
namecom dns delete --domain example.com --id <id>

# Nameservers
namecom nameservers list --domain example.com
namecom nameservers set --domain example.com --nameservers ns1.example.com,ns2.example.com

# Contacts
namecom contacts list
namecom contacts create --first-name John --last-name Doe --email john@example.com

# Transfers
namecom transfers list
namecom transfers create --domain example.com --auth-code xxxx

Authentication

export NAMECOM_TOKEN=username:api_token

Generate an API token at name.com - Account > API Settings. The token format is username:token. Test against the OTE environment at api.dev.name.com by setting NAMECOM_API_URL=https://api.dev.name.com/v4.

Forma Protocol

This tool is built to the Forma Protocol specification.

• Output: {data, meta} JSON envelope with --json flag
• Exit codes: Semantic codes 0-7 (0 = success, 1 = general error, 2 = auth, 3 = not found)
• Auth: namecom auth login / namecom auth status / namecom auth logout
• Flags: --json, --limit, --fields, --version on all commands