Loading
Loading
Retrieve historical WHOIS records for any domain, tracking ownership changes, name server updates, and registration details over time. Access billions of records dating back to 1986 for cybersecurity forensics, brand protection, and domain investment research.
The Domain WHOIS History Lookup API provides chronological domain registration records, allowing you to trace changes in ownership, contact information, and name servers across time.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The following parameters can be used in your API requests. All parameters are passed as query string parameters.
domainNamerequiredStringDomain name or URL whose historical WHOIS required.
A successful request returns a 200 OK response with a JSON object containing the WHOIS historical data. The response includes the top-level fields listed below. See the response preview on the right for the full JSON structure.
statusDetermines whether the request was successfully processed or not.
whoisIndicates that this response contains historical data. Possible value: historical.
total_recordsShows the total number of records found for the queried domain.
whois_domains_historicalList of domain's WHOIS records. Each object contains the following fields.
List of domain's WHOIS records. Each object contains the following fields:
numShows the number of the record in the array.
statusAlways true.
domain_nameDomain name which was queried.
domain_handleThe unique handle identifier assigned by the registry to the domain.
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. This unique identifier is assigned to domain registrars by the IANA to ensure their recognition and regulation in the domain name system.
domain_registrar.handleThe unique handle identifier of the registrar.
domain_registrar.statusThe accreditation status of the registrar. Possible value: accredited.
domain_registrar.registrar_nameThe name of the registrar managing the domain.
domain_registrar.normalized_nameThe normalized (lowercase) name of the registrar.
domain_registrar.whois_serverThe registrar WHOIS server for domain queries.
domain_registrar.rdap_serverThe RDAP server URL of the registrar.
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 managing the object.
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.
abuse_contactAbuse contact information for reporting domain abuse.
abuse_contact.registrar_nameThe name of the registrar handling abuse reports.
abuse_contact.email_addressThe email address to report abuse.
abuse_contact.phone_numberThe phone number to report abuse.
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:
handleUnique identifier for the contact in the WHOIS database.
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.
mailingaddressMailing address of the responsible person (legacy format).
The abuse_contact object contains the following fields:
registrar_nameThe name of the registrar handling abuse reports.
email_addressThe email address to report abuse.
phone_numberThe phone number to report abuse.
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. This unique identifier is assigned to domain registrars by the IANA to ensure their recognition and regulation in the domain name system.
domain_registrar.handleThe unique handle identifier of the registrar.
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 managing the object.
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.
Invalid domain name parameters. Please pass domain param correct value e.g. whoisfreaks.com, https://whoisfreaks.com , http://whoisfreaks.com
Record not found.
Service is unavailable.
Request is timed-out.