Reverse WHOIS API

GET

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

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
totalResult	Integer	Mandatory	Total results found across the query
totalPages	Integer	Mandatory	Total number of pages (50 records per page)
currentPage	Integer	Mandatory	Current number of page
whois_domains_historical	List<Historical WHOIS response>	Mandatory	List of historical WHOIS responses matching the criteria

DEFAULT MODE

historical WHOIS response object contains following fields in default mode:

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: (1) yes - domain is registered (2) no - domain is not registered (3) restricted - domain is restricted by the registry or registrar and cannot 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.
email_address	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.
mailing_address	String	Optional	Mailing address of the responsible person.

Registry 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: (1) yes - domain is registered (2) no - domain is not registered (3) restricted - domain is restricted by the registry or registrar and cannot 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.

MINI MODE

historical WHOIS response object contains following fields in mini mode:

Field	Type	Requirement	Description
num	Integer	Mandatory	Number of the record.
domain_name	String	Mandatory	Name of the associated domain.
create_date	String	Optional	Date the domain was created. (Format: YYYY-MM-DD)
update_date	String	Optional	Date the domain was last updated. (Format: YYYY-MM-DD)
expiry_date	String	Optional	Date the domain will expire if not renewed. (Format: YYYY-MM-DD)
name	String	Optional	Name of the person who registered the domain.
email	String	Optional	Email of the person who registered the domain.
companyname	String	Optional	Name of the company to which the domain name is associated.