What authentication method is required? | Use HTTP Basic Authentication with your Name.com username and API token, encoded in the Authorization header. |
Is Two-Factor Authentication (2FA) supported with the API? | ❌ No. Accounts with 2FA enabled cannot authenticate. Disable 2FA and enable API Access in your account settings. |
Can I call the API from JavaScript in the browser? | ❌ No. The API is for server-side use only. Browser requests are blocked due to CORS restrictions. |
Can I use PowerShell? | ✅ Yes. Any tool that can send HTTPS requests — including PowerShell, curl, Python, or Node.js — is supported. |
Which port should I use? | All API requests must use HTTPS on port 443. |
Are production and sandbox accounts synced? | ❌ No. Domains, DNS records, and user data are completely separate between environments. |
Does the sandbox environment exactly match production? | ❌ No. The sandbox uses registry test data, so domain availability and behavior may differ. |
How can I test domain registration without real charges? | Use the sandbox environment (https://api.dev.name.com ) with your -test username and sandbox API token. Sandbox domains are not live or publicly registered. |
What status codes does the API use? | The API uses standard RESTful HTTP codes like 200 OK, 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, and 429 Too Many Requests. |
Why is my GetDomain request failing? | The domain must exist in the environment you’re querying. Check whether you're using sandbox or production. |
What is the domain search limit? | You can check up to 50 domains per checkAvailability call. |
What happens if I hit the rate limit? | You’ll receive a 429 Too Many Requests error. Use backoff logic and retry after a delay. |
Can I use saved payment profiles with the API? | ✅ Yes. You can use saved credit card profiles and account credit for domain purchases via the API. Ensure your preferred payment method is set as the default payment method within your account. |
How do I know when a new API version is available? | 🔔 Check the Changelog for the latest version releases, features, and any upcoming deprecations. |