Skip to content
Domains
/
Zone Check

name.com Core API (1.3.1)

RESTful API for managing domains, DNS records, and related services at name.com. Access via HTTPS at api.name.com (production) or api.dev.name.com (testing). Supports standard authentication, rate-limited to 20 requests/second.

Download OpenAPI description
namecom.api.json
namecom.api.yaml
Overview
Account Services

accountservices@name.com

Terms of Service

Languages
Servers
Mock server

https://docs.name.com/_mock/api-spec-cdn/namecom.api/

Testing

https://api.dev.name.com/

Hello

Use the Hello endpoint to verify that your API connection and credentials are working properly. This simple call returns a success message (along with server time and version info) to confirm the API is reachable and authenticated.

Operations

Account Info

Use Account Info endpoints to retrieve basic information about your name.com account. For example, you can check your account’s current credit balance and other account details using these endpoints.

Operations

Accounts

Use Accounts endpoints (available upon request) to manage sub-accounts under your main account. For example, resellers can programmatically create new customer accounts with their own login credentials and permissions.

Operations

Domains

Use Domains endpoints to search for domain availability, register new domains, and manage existing domains.

Operations

Search

Request

Searches for domain name suggestions based on a keyword or term. Important: Do not encode the : in the path. Use /core/v1/domains:search, not /core/v1/domains%3Asearch.

Security
BasicAuth
Bodyapplication/jsonrequired

SearchRequest is used to specify the search parameters.

keywordstringrequired

Keyword is the search term to search for. It can be just a word, or a whole domain name.

Example: "mydomain"
timeoutinteger(int32)

Timeout is a value in milliseconds on how long to perform the search for. Valid timeouts are between 500ms to 12,000ms. If not specified, timeout defaults to 12,000ms. Since some additional processing is performed on the results, a response may take longer then the timeout.

Example: 2500
tldFilterArray of strings<= 50 items

TLDFilter will limit results to only contain the specified TLDs. There is a maximum of 50 TLDs that can be used in this filter

Example: ["com","net","org"]
curl -i -X POST \
  -u <username>:<password> \
  https://docs.name.com/_mock/api-spec-cdn/namecom.api/core/v1/domains:search \
  -H 'Content-Type: application/json' \
  -d '{
    "keyword": "mydomain",
    "timeout": 2500,
    "tldFilter": [
      "com",
      "net",
      "org"
    ]
  }'

Responses

A successful response.

Bodyapplication/json
resultsArray of objects(SearchResult)

Results of the search are returned here, the order should not be relied upon.

Response
application/json
{
  "results": [
    { … }
  ]
}

Zone Check

Request

Zone Check offers a rapid, preliminary check for domain availability by leveraging cached zone file data. Ideal for large-batch queries, it provides a high confidence indication of a domain's availability significantly faster than live registry checks. For definitive, real-time availability and pricing, you can follow up with the standard Check Availability call. The API first validates each submitted domain. Invalid domains are filtered out, and their count is returned in the removed field of the response. If no valid domains remain after this process, the API returns a 400 Bad Request response. Note: The cached zone files used for this check are refreshed twice daily based on the latest available data from the registries.

Security
BasicAuth
Bodyapplication/jsonrequired

Request body to check for availability

domainNamesArray of strings[ 1 .. 500 ] itemsrequired

Array of domains to check

curl -i -X POST \
  -u <username>:<password> \
  https://docs.name.com/_mock/api-spec-cdn/namecom.api/core/v1/zonecheck \
  -H 'Content-Type: application/json' \
  -d '{
    "domainNames": [
      "example.com",
      "example.net",
      "example.org"
    ]
  }'

Responses

Successful response for a DNS zone check.

Bodyapplication/json
resultsArray of objects(ZoneCheckResult)required
results[].​domainNamestringrequired

The domain name that was checked

Example: "example.com"
results[].​availableboolean or nullrequired

If the domain is potentially available for purchase after checking for it's presense in the DNZ zone files.

totalnumber(int32)required

Total number of records checked

Example: 5
removednumber(int32)

Total number of domains removed from the check because they are invalid

Example: 1
Response
application/json
{
  "results": [
    { … }
  ],
  "total": 5,
  "removed": 1
}

Disable AutorenewDeprecated

Request

Turns off automatic renewal for a domain. DEPRECATED This endpoint is deprecated in favor of the new UpdateDomain API. This will be removed in a future release.

Security
BasicAuth
Path
domainNamestringrequired

DomainName is the domain name to disable autorenew for.

Example: example.com
Headers
Content-Typestringrequired

Required Content-Type Header for POST requests.

Value"application/json"
curl -i -X POST \
  -u <username>:<password> \
  https://docs.name.com/_mock/api-spec-cdn/namecom.api/core/v1/domains/example.com:disableAutorenew \
  -H 'Content-Type: application/json'

Responses

A successful response.

Bodyapplication/json
domainNamestring

The punycode-encoded value of the domain name.

Example: "example.com"
createDatestring(date-time)read-only

The date and time when the domain was created at the registry.

Example: "2023-01-15T14:30:00Z"
expireDatestring(date-time)read-only

The date and time when the domain will expire.

Example: "2025-01-15T14:30:00Z"
autorenewEnabledboolean

Indicates whether the domain is set to renew automatically before expiration.

Example: true
lockedboolean

Indicates if the domain is locked, preventing transfers to another registrar.

Example: true
privacyEnabledboolean

Indicates if Whois Privacy is enabled for this domain.

Example: true
contactsobject(Contacts)

Contacts stores the contact information for the roles related to domains.

nameserversArray of strings

The list of nameservers assigned to this domain. If unspecified, it defaults to the account's default nameservers.

Example: ["ns1.example.com","ns2.example.com"]
renewalPricenumber(double)read-only

The cost to renew the domain. This may be required for the RenewDomain operation.

Example: 12.99
Response
application/json
{
  "domainName": "example.com",
  "createDate": "2023-01-15T14:30:00Z",
  "expireDate": "2025-01-15T14:30:00Z",
  "autorenewEnabled": true,
  "locked": true,
  "privacyEnabled": true,
  "contacts": {
    "admin": { … },
    "billing": { … },
    "registrant": { … },
    "tech": { … }
  },
  "nameservers": [
    "ns1.example.com",
    "ns2.example.com"
  ],
  "renewalPrice": 12.99
}

DNS

Use DNS endpoints to manage DNS records for your domains. You can list all existing DNS records for a domain and create, update, or delete records as needed.

Operations

DNSSECs

Use DNSSEC endpoints to configure DNS Security Extensions for your domains. These endpoints allow you to add, retrieve, or remove DNSSEC records.

Operations

Email Forwardings

Use Email Forwardings endpoints to set up and manage email forwarding addresses on your domains.

Operations

URL Forwardings

Use URL Forwardings endpoints to control URL redirection settings for your domains.

Operations

Vanity Nameservers

Use Vanity Nameservers endpoints to configure custom nameserver hostnames (glue records) for your domains.

Operations

Transfers

Use Transfers endpoints to move domains into your name.com account. Start by creating a transfer request, then monitor and manage the status of pending transfers. You can also cancel a transfer if needed.

Operations

Orders

Use Orders endpoints to review and track purchases made via the API.

Operations

Webhook Notifications

Use Webhook Notification endpoints to subscribe to real-time notifications for account and domain events. This keeps your application updated on important changes without polling the API.

OperationsWebhooks

Domain Info

Use Domain Info endpoints to retrieve information about TLD-specific requirements and registration rules. These endpoints help you understand what fields, documents, or constraints are needed to successfully register domains across different TLDs.

Operations

TLD Pricing

Use TLD Pricing endpoints to retrieve general pricing information for your account.

Operations