Skip to main content
POST
/
core
/
v1
/
domains:checkAvailability
Check Availability
curl --request POST \
  --url https://api.dev.name.com/core/v1/domains:checkAvailability \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "domainNames": [
    "<string>"
  ]
}'
{
  "results": [
    {
      "domainName": "example.com",
      "premium": true,
      "purchasable": true,
      "purchasePrice": 10.99,
      "purchaseType": "registration",
      "renewalPrice": 10.99,
      "sld": "example",
      "tld": "com"
    }
  ]
}

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

AvailabilityRequest is used to list the domain names to check availability for.

Checks if one or more domain names are available for registration (up to 50 domains). Important: Do not encode the : in the path. Use /core/v1/domains:checkAvailability, not /core/v1/domains%3AcheckAvailability.

​
domainNames
string[]
required

DomainNames is the list of domains to check if they are available.

Required array length: 1 - 50 elements

Response

A successful response.

SearchResponse returns a list of search results.

​
results
object[]

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

⌘I