Making requests | Documentation old | Domain Availability API | WhoisXML API

Making requests

Domain Availability API helps you check whether a domain name is available for registration quickly and accurately.

WhoisXmlApi.com provides RESTful APIs. It is designed for server-to-server communication between your system and the WhoisXmlApi.com network using standard HTTP or HTTPS protocols. Query responses are delivered in either XML or JSON format based on your requests which are made via GET method.

To get started you need a developer's account with WhoisXmlApi.com. Authentication is required each time in order to use the API. The first 100 domain name availability lookups are complimentary when you register for a free developer account.


GET https://www.whoisxmlapi.com/whoisserver/WhoisService?cmd=GET_DN_AVAILABILITY
It takes up to a minute to activate your account after the registration.

Input parameters

apiKey

Required. Get your personal API KEY on My products page.

domainName

Required. The target domain name.

username

Required unless ApiKey authentication is used, your account username.

password

Required unless ApiKey authentication is used, your account password.

Make sure it is URL-encoded if it contains special characters (&, %, * etc.).

requestObject

Required unless password authentication is used, encoded user identifier for ApiKey authentication.

digest

Required unless password authentication is used, ApiKey access token.

cmd

Required = GET_DN_AVAILABILITY

getMode

Optional. The default mode is the fastest, the DNS_AND_WHOIS mode is slower but more accurate.

Acceptable values: DNS_AND_WHOIS | DNS_ONLY

Default: DNS_ONLY

outputFormat

Optional. Response output format.

Acceptable values: JSON | XML

Default: XML

Free access

After Sign Up you automatically get a free subscription plan limited to 100 queries per month.

Usage limits and requests throttling

The maximum number of requests per second is 30. In case that the limit is breached, your subsequent requests will be rejected until the next second.

Have questions?

We are here to listen. For a quick response, please select your request type or check our Contact us page for more information. By submitting a request, you agree to our Terms of Service and Privacy Policy.

Or shoot us an email to