Skip to main content
POST
/
core
/
v1
/
zonecheck
Zone Check
curl --request POST \
  --url https://api.dev.name.com/core/v1/zonecheck \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "domainNames": [
    "example.com",
    "example.net",
    "example.org"
  ]
}'
{
  "results": [
    {
      "domainName": "example.com",
      "available": true
    }
  ],
  "total": 5,
  "removed": 1
}

Authorizations

​
Authorization
string
header
required

Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.

Body

application/json

Request body to check for availability

ZoneCheck request checks DNS zone files for the availability of the specified domains.

​
domainNames
string[]
required

Array of domains to check

Required array length: 1 - 500 elements
Examples:
["example.com", "example.net", "example.org"]
["test.net"]

Response

Successful response for a DNS zone check.

Response for checking domain availability via DNS zone checks.

​
results
object[]
required
​
total
number
required

Total number of records checked

Example:

5

​
removed
number

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

Example:

1

⌘I