Domain Availability Check API

The Domain Availability Check API will return the status of a domain submitted via the API.

Hostname

The Domain Availability API hostname is environment specific, see production or OTE environment sections.

Single domain input parameter

Domain name (a-label or u-label):

• /api/domain/validate?domain=<domain-name>

Output parameters

• Domain name

• Status

Note

Multiple statuses can be displayed for a single availability check. All relevant statuses will be listed in the response.

Possible status options:

• Available

• Registered

• Premium

• Blocked

• Blocked Override

• Bundle

• Invalid – possible reasons for an invalid response are:

  • TLD: the TLD does not match the Registry TLD

  • Length: the length of the domain name is not within the configuration bounds

  • Levels: the domain does not have a zone or a level tag that allows its creation

  • Level length: the subdomain levels are not within the configuration bounds

  • Syntax: the domain did not pass the syntax check

  • IDN: the IDN domain name contains an invalid character

Sample output:

{
    "domainName" : "testdomain.kiwi",
    "statuses" : [ "REGISTERED" ]
}