Domain WHOIS History Lookup API

GET

https://api.apifreaks.com/v1.0/domain/whois/history

Sample Responses

400

404

LANGUAGE

Python

PHP

Java

Node

Ruby


$ pip install requests

RESPONSE

Click Test it to start the request and see the response here!

API Response

Field

Type

Requirement

Description

status

Boolean

Mandatory

Determines whether the request was successfully processed or not.

whois

String

Mandatory

Indicates that this response contains historical data. Possible value: <br> (1) historical.

total_records

String

Mandatory

Shows the total number of records found for the queried domain.

whois_domains_historical

Array

Mandatory

List of domain's WHOIS records. Each object contains the following fields

Field	Type	Requirement	Description
num	Integer	Mandatory	Shows the number of the record in the array.
status	Boolean	Mandatory	Always true
domain_name	String	Mandatory	Domain name which was queried
query_time	String	Mandatory	The timestamp when the query was made. (format YYYY-MM-DD HH:mm:ss)
whois_server	String	Mandatory	The WHOIS server that provided the domain information.
domain_registered	String	Mandatory	Determines whether the requested domain is registered/not registered or is restricted. Possible values are:<br> (1) yes - domain is registered <br> (2) no - domain is not registered <br> (3) restricted - domain is restricted by the registry or registrar and can not be registered
create_date	String	Optional	Date when the domain was initially registered (format: YYYY-MM-DD)
update_date	String	Optional	The date (format: YYYY-MM-DD) of the most recent update to the domain registration.
expiry_date	String	Optional	The date (format: YYYY-MM-DD) when the domain registration will expire if not renewed.
domain_registrar.iana_id	String	Optional	The 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.registrar_name	String	Optional	The name of the registrar managing the domain.
domain_registrar.whois_server	String	Optional	The WHOIS server that provided the domain information.
domain_registrar.website_url	String	Optional	The website URL of the registrar managing the domain.
domain_registrar.email_address	String	Optional	The email address of registrar contact
domain_registrar.phone_number	String	Optional	The phone number of the registrar managing the object.
reseller_contact	Object	Optional	Third party between the registrar and registrant.
reseller_contact.name	String	Optional	Name of the reseller.
reseller_contact.email_address	String	Optional	Email address of the reseller.
reseller_contact.phone	String	Optional	Phone number of the reseller.
registrant_contact	Object	Optional	Contact details of the domain's owner.
administrative_contact	Object	Optional	Contact details of the domain administrator.
technical_contact	Object	Optional	Contact details of the technical person.
billing_contact	Object	Optional	Contact details of the person handling billing operations.
name_servers	Array	Optional	Name servers of the domain.
domain_status	Array	Optional	Status of the domain.
whois_raw_domain	String	Optional	Raw WHOIS data for the domain
registry_data	Object	Optional	Registry data of the domain.

The registrant_contact, administrative_contact, technical_contact, and billing_contact objects contain the following fields:

Field	Type	Requirement	Description
name	String	Optional	Name of the person.
company	String	Optional	Name of the company.
street	String	Optional	Street name.
city	String	Optional	City of the responsible person.
state	String	Optional	State of the responsible person.
zip_code	String	Optional	Zip code of the responsible person.
country_name	String	Optional	Country name of the responsible person.
country_code	String	Optional	Country code of the responsible person.
emailaddress	String	Optional	Email address of the responsible person.
phone	String	Optional	Phone number of the responsible person.
fax	String	Optional	Fax of the responsible person.
mailingaddress	String	Optional	Mailing address of the responsible person.

The registry_data object contains following fields:

Field	Type	Requirement	Description
domain_name	String	Optional	Name of the domain.
query_time	String	Optional	The timestamp when the query was made (format: YYYY-MM-DD HH:mm:ss).
whois_server	String	Optional	The WHOIS server that provided the domain information.
domain_registered	String	Optional	Determines whether the requested domain is registered/not registered or is restricted. Possible values are:<br> (1) yes - domain is registered <br> (2) no - domain is not registered <br> (3) restricted - domain is restricted by the registry or registrar and can not be registered
create_date	String	Optional	Date when the domain was initially registered (format: YYYY-MM-DD).
update_date	String	Optional	The date (format: YYYY-MM-DD) of the most recent update to the domain registration.
expiry_date	String	Optional	The date (format: YYYY-MM-DD) when the domain registration will expire if not renewed.
name_servers	Array	Optional	Name servers of the domain.
domain_status	Array	Optional	Status of the domain.
whois_raw_registry	String	Optional	Raw WHOIS data from the registry.
domain_registrar	Object	Optional	Registrar information.
domain_registrar.iana_id	String	Optional	The 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.registrar_name	String	Optional	The name of the registrar managing the domain.
domain_registrar.whois_server	String	Optional	The WHOIS server that provided the domain information.
domain_registrar.website_url	String	Optional	The website URL of the registrar managing the domain.
domain_registrar.email_address	String	Optional	The email address of the registrar contact.
domain_registrar.phone_number	String	Optional	The phone number of the registrar managing the object.