WHOIS IP Lookup API

GET

https://api.apifreaks.com/v1.0/ip/whois/live

Sample Responses

400

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

Indicates if the WHOIS response from whois_server is a complete response

ip_address

String

Mandatory

IP address (IPv4 or IPv6) to query live WHOIS

query_time

String

Mandatory

Date and time of WHOIS query in the yyyy-MM-dd HH:mm:ss format

whois_server

String

Mandatory

WHOIS host server used to query the ip_address

inet_nums

Array

Mandatory

List of inet nums. Each object contains the following fields:

Field	Type	Requirement	Description
start_ip	String	Mandatory	Start IP in the IP range
end_ip	String	Mandatory	End IP in the IP range
cidr	String	Mandatory	IP range in the CIDR format
net_name	String	Mandatory	Net-Name (unique ID) of this inetnum in the WHOIS data
net_handle	String	Optional	Net-Handle (unique ID) of this inetnum in the WHOIS data, only available in the ARIN's response
description	List<String>	Optional	All values of `description` in this inetnum
countries	List<String>	Mandatory	All ISO 3166-2 letter country codes from where the IP block is allocated
geofeed	String	Optional	Link to the geofeed
latitude	Float	Optional	Latitude value parsed from `geoloc` in the inetnum object
longitude	Float	Optional	Longitude value parsed from `geoloc` in the inetnum object
city	String	Optional	City of allocation for the inetnum, only returned from the LACNIC's response
languages	List<String>	Optional	All regional languages in countries of allocation
status	String	Mandatory	Allocation or assignment status
organization	String	Optional	Handle (unique ID) of the organization in WHOIS data, managing this inetnum
sponsoring_organization	String	Optional	Handle (unique ID) of the sponsoring organization in WHOIS data, sponsoring this inetnum
admin_contacts	List<String>	Mandatory	All handles (unique IDs) of admin persons or roles in WHOIS data
tech_contacts	List<String>	Mandatory	All handles (unique IDs) of tech persons or roles in WHOIS data
abuse_contacts	List<String>	Optional	All handles (unique IDs) of abuse persons or roles in WHOIS data
remarks	List<String>	Optional	All values of `remarks` in inetnum object
assignment_size	String	Optional	Allocation or assignment size of IP network or block
notify	List<String>	Optional	All values of `notify` in the inetnum object
mnt_by	List<String>	Optional	All values of `mnt-by` in the inetnum object
mnt_lower	List<String>	Optional	All values of `mnt-lower` in the inetnum object
mnt_domains	List<String>	Optional	All values of `mnt-domains` in the inetnum object
mnt_routes	List<String>	Optional	All values of `mnt-routes` in the inetnum object
mnt_irt	List<String>	Optional	All values of `mnt-irt` in the inetnum object
date_created	String	Optional	This object's registration date, parsed in yyyy-MM-dd format
date_updated	String	Mandatory	This object's last update date, parsed in yyyy-MM-dd format
source	String	Mandatory	WHOIS data source of this object
parents	String	Optional	Parent allocations or assignments of this inetnum block

irt.handle

String

Mandatory

Handle or unique identifier of this irt in the WHOIS data

irt.address

List<String>

Mandatory

All values of address in the irt object

irt.street

String

Optional

Parsed street addressfrom address

irt.city

String

Optional

Parsed cityfrom address

irt.district

String

Optional

Parsed districtfrom address

irt.state

String

Optional

Parsed statefrom address

irt.zip_code

String

Optional

Parsed ZIP codefrom address

irt.country

String

Optional

Parsed countryfrom address

irt.email

List<String>

Mandatory

All values of email in the irt object

irt.abuse_mailbox

List<String>

Optional

All values of abuse-mailbox in the irt object

irt.phone

List<String>

Optional

All values of phone in the irt object

irt.fax_no

List<String>

Optional

All values of fax-no in the irt object

irt.organizations

List<String>

Optional

All handles of organization objects, irt object is linked to

irt.admin_contacts

List<String>

Mandatory

All handles (unique IDs) of admin persons or roles in WHOIS data

irt.tech_contacts

List<String>

Mandatory

All handles (unique IDs) of tech persons or roles in WHOIS data

irt.remarks

List<String>

Optional

All values of remarks in the irt object

irt.signature

List<String>

Optional

All values of signature in the irt object

irt.encryption

List<String>

Optional

All values of encryption in the irt object

irt.auth

List<String>

Optional

All values of auth in the irt object

irt.notify

List<String>

Optional

All values of notify in the irt object

irt.irt_nfy

List<String>

Optional

All values of irt-nfy in the irt object

irt.mnt_by

List<String>

Optional

All values of mnt-by in the irt object

irt.mnt_ref

List<String>

Optional

All values of mnt-ref in the irt object

irt.date_created

String

Optional

This object's registration date, parsed in yyyy-MM-dd format

irt.date_updated

String

Mandatory

This object's last update date, parsed in yyyy-MM-dd format

irt.source

String

Mandatory

WHOIS data source of this object

organization.handle

String

Mandatory

Handle or unique identifier of this organization object in WHOIS data

organization.name

String

Mandatory

Name of the organization

organization.type

String

Optional

Type of the organization

organization.description

List<String>

Optional

All values of description in the organization object

organization.address

List<String>

Mandatory

All values of address in the organization object

organization.street

String

Optional

Parsed street addressfrom address

organization.city

String

Optional

Parsed cityfrom address

organization.district

String

Optional

Parsed districtfrom address

organization.state

String

Optional

Parsed statefrom address

organization.zip_code

String

Optional

Parsed ZIP codefrom address

organization.country

String

Optional

Parsed countryfrom address

organization.latitude

Float

Optional

latitude parsed from the geoloc field

organization.longitude

Float

Optional

longitude parsed from the geoloc field

organization.email

List<String>

Mandatory

All values of email in the organization object

organization.abuse_mailbox

List<String>

Optional

All values of abuse-mailbox in the organization object

organization.phone

List<String>

Optional

All values of phone in the organization object

organization.fax_no

List<String>

Optional

All values of fax-no in the organization object

organization.organizations

List<String>

Optional

All handles of organization objects, organization object is linked to

organization.admin_contacts

List<String>

Optional

All handles (unique IDs) of admin persons or roles in WHOIS data

organization.tech_contacts

List<String>

Optional

All handles (unique IDs) of tech persons or roles in WHOIS data

organization.abuse_contacts

List<String>

Optional

All handles (unique IDs) of abuse persons or roles in WHOIS data

organization.languages

List<String>

Optional

All values of language in the organization object

organization.remarks

List<String>

Optional

All values of remarks in the organization object

organization.notify

List<String>

Optional

All values of notify in the organization object

organization.ref_nfy

List<String>

Optional

All values of ref-nfy in the organization object

organization.mnt_by

List<String>

Optional

All values of mnt-by in the organization object

organization.mnt_ref

List<String>

Optional

All values of mnt-ref in the organization object

organization.date_created

String

Optional

This object's registration date, parsed in yyyy-MM-dd format

organization.date_updated

String

Mandatory

This object's last update date, parsed in yyyy-MM-dd format

organization.source

String

Mandatory

WHOIS data source of this object

administrative_contacts

List<Object>

Optional

List of administrative contacts

technical_contacts

List<Object>

Optional

List of technical contacts

abuse_contacts

List<Object>

Optional

List of abuse contacts

routes

List<Object>

Optional

List of routes. Each object in the list contains following fields:

Field	Type	Requirement	Description
route	String	Mandatory	BGP route
origin	String	Mandatory	AS number
description	List<String>	Optional	All values of `description` in the route
country	String	Optional	Country of organization, managing this route
pingable	List<String>	Optional	All values of `pingable` in the route
ping_hdl	List<String>	Optional	All values of `ping-hdl` in the route
holes	List<String>	Optional	All values of `holes` in the route
member_of	List<String>	Optional	All values of `member-of` in the route
inject	List<String>	Optional	All values of `inject` in the route
aggr_mtd	String	Optional	Value of `aggr-mtd` in the route
aggr_bndry	String	Optional	Value of `aggr-bndry` in the route
export_comps	String	Optional	Value of `export-comps` in the route
components	String	Optional	Value of `components` in the route
organizations	List<String>	Optional	All handles of Organization objects related to the route
remarks	List<String>	Optional	All values of `remarks` in the route
notify	List<String>	Optional	All values of `notify` in the route
mnt_lower	List<String>	Optional	All values of `mnt-lower` in the route
mnt_by	List<String>	Optional	All values of `mnt-by` in the route
date_created	String	Optional	This object's registration date, parsed in yyyy-MM-dd format
date_updated	String	Mandatory	This object's last update date, parsed in yyyy-MM-dd format
source	String	Mandatory	WHOIS data source of this object

whois_raw_response

String

Mandatory

WHOIS response (unparsed) from the whois_server WHOIS server

r_whois_raw_response

String

Mandatory

WHOIS response from the rwhois server

Each object within the lists of administrative contacts, technical contacts, and abuse contacts comprises the following fields:

Field	Type	Requirement	Description
handle	String	Mandatory	Handle or unique identifier of this person or role object in WHOIS data
name	String	Mandatory	Name of the person or role
address	List<String>	Mandatory	All values of `address` in the object
street	String	Optional	Parsed `street address` from address
city	String	Optional	Parsed `city` from address
district	String	Optional	Parsed `district` from address
state	String	Optional	Parsed `state` from address
zip_code	String	Optional	Parsed `ZIP code` from address
country	String	Optional	Parsed `country` from address
email	List<String>	Mandatory	All values of `email` in the object
abuse_mailbox	List<String>	Optional	All values of `abuse-mailbox` in the object
phone	List<String>	Optional	All values of `phone` in the object
fax_no	List<String>	Optional	All values of `fax-no` in the object
organizations	List<String>	Optional	All handles of `organization` objects, managing this person or role object
admin_contacts	List<String>	Optional	All handles (unique IDs) of admin persons or roles in WHOIS data
tech_contacts	List<String>	Optional	All handles (unique IDs) of tech persons or roles in WHOIS data
remarks	List<String>	Optional	All values of `remarks` in the person or role object
notify	List<String>	Optional	All values of `notify` in the person or role object
mnt_by	List<String>	Optional	All values of `mnt-by` in the person or role object
mnt_ref	List<String>	Optional	All values of `mnt-ref` in the person or role object
date_created	String	Optional	This object's registration date, parsed in yyyy-MM-dd format
date_updated	String	Mandatory	This object's last update date, parsed in yyyy-MM-dd format
source	String	Mandatory	WHOIS data source of this object