Loading
Loading
Perform bulk WHOIS lookups for up to 100 domains in a single request. Retrieve structured registration, contact, and name server data for cybersecurity analysis, brand monitoring, and domain intelligence at scale.
The Bulk WHOIS Lookup API accepts a JSON array of domain names via POST and returns an array of WHOIS objects — one per domain. Each object uses the same structure as the single-domain WHOIS Domain Lookup response.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
Send a POST request with a JSON body containing the domainNames array. Each entry can be a domain name or URL. Maximum 100 domains per request.
The request body must be a JSON object containing a domainNames array of up to 100 domain names or URLs to look up.
{
"domainNames": [
"google.com",
"microsoft.com"
]
}A successful request returns a 200 OK response with a JSON array containing WHOIS data for each domain. Partial successes return 206, and cached data returns 210. See the response preview on the right for the full JSON structure.
bulk_whois_responseList of WHOIS objects for each domain name from the request. Each object contains the following fields:
Each domain object in the array contains the following fields:
statusDetermines whether the request was successfully processed or not. If a specific domain name fails to retrieve a WHOIS record or encounters an error, the status will be indicated as false.
domain_nameDomain name which was queried.
query_timeThe timestamp when the query was made (format YYYY-MM-DD HH:mm:ss).
whois_serverThe WHOIS server that provided the domain information.
domain_registeredDetermines whether the requested domain is registered/not registered or is restricted. Possible values are:
create_dateDate when the domain was initially registered (format: YYYY-MM-DD).
update_dateThe date (format: YYYY-MM-DD) of the most recent update to the domain registration.
expiry_dateThe date (format: YYYY-MM-DD) when the domain registration will expire if not renewed.
domain_registrarRegistrar information.
domain_registrar.iana_idThe IANA (Internet Assigned Numbers Authority) ID of the registrar managing the domain.
domain_registrar.registrar_nameThe name of the registrar managing the domain.
domain_registrar.whois_serverThe registrar WHOIS server for domain queries.
domain_registrar.website_urlThe website URL of the registrar managing the domain.
domain_registrar.email_addressThe email address of registrar contact.
domain_registrar.phone_numberThe phone number of the registrar.
reseller_contactThird party between the registrar and registrant.
reseller_contact.nameName of the reseller.
reseller_contact.email_addressEmail address of the reseller.
reseller_contact.phonePhone number of the reseller.
registrant_contactContact details of the domain's owner.
administrative_contactContact details of the domain administrator.
technical_contactContact details of the technical person.
billing_contactContact details of the person handling billing operations.
name_serversName servers of the domain.
domain_statusStatus of the domain.
whois_raw_domainRaw WHOIS data for the domain.
registry_dataRegistry data of the domain.
Each contact object contains the following fields:
nameName of the person.
companyName of the company.
streetStreet name.
cityCity of the responsible person.
stateState of the responsible person.
zip_codeZip code of the responsible person.
country_nameCountry name of the responsible person.
country_codeCountry code of the responsible person.
email_addressEmail address of the responsible person.
phonePhone number of the responsible person.
faxFax of the responsible person.
mailing_addressFormatted mailing address of the responsible person.
The registry_data object contains the following fields:
domain_nameName of the domain.
query_timeThe timestamp when the query was made (format: YYYY-MM-DD HH:mm:ss).
whois_serverThe registry WHOIS server that provided the domain information.
domain_registeredDetermines whether the requested domain is registered/not registered or is restricted. Possible values are:
create_dateDate when the domain was initially registered (format: YYYY-MM-DD).
update_dateThe date (format: YYYY-MM-DD) of the most recent update to the domain registration.
expiry_dateThe date (format: YYYY-MM-DD) when the domain registration will expire if not renewed.
name_serversName servers of the domain.
domain_statusStatus of the domain.
whois_raw_registryRaw WHOIS data from the registry.
domain_registrarRegistrar information.
domain_registrar.iana_idThe IANA (Internet Assigned Numbers Authority) ID of the registrar managing the domain.
domain_registrar.registrar_nameThe name of the registrar managing the domain.
domain_registrar.whois_serverThe registrar WHOIS server for domain queries.
domain_registrar.website_urlThe website URL of the registrar managing the domain.
domain_registrar.email_addressThe email address of the registrar contact.
domain_registrar.phone_numberThe phone number of the registrar.
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
Partial response. One or more domain names failed.
Cached response. One or more domain names retrieved from cache.
Invalid domain name parameters. Please pass domain param correct value e.g. whoisfreaks.com, https://whoisfreaks.com , http://whoisfreaks.com
Service is unavailable.
Request is timed-out.