WHOIS IP Lookup API - Complete IP Registration and Ownership Details

The WHOIS IP Lookup API offers real-time WHOIS information for both IPv4 and IPv6 addresses. Designed to deliver precise IP WHOIS data, this API provides detailed insights into IP address registration and ownership. Whether you need accurate IP WHOIS lookups or a dependable WHOIS IP checker, our API ensures comprehensive data for effective IP management.

With the WHOIS IP Lookup API, you can seamlessly conduct WHOIS searches by IP, monitor IP address ownership, and obtain reliable IP address lookup WHOIS results. Ideal for cybersecurity experts, network administrators, and data analysts, this API enhances your IP management strategies and provides actionable insights to support informed decision-making.

10K Free Credits, No Credit Card Required

Features

Support IPv4 and IPv6 Address Space

Access comprehensive WHOIS IP lookup data for both IPv4 and IPv6 addresses. Our API delivers detailed information on IP address registration and ownership across the entire IP address space. This ensures full coverage for accurate IP WHOIS lookups and effective IP management. Whether you need to analyze IPv4 or IPv6 addresses, our API provides reliable data to support advanced IP intelligence and network management.

Real-Time Data

Receive real-time WHOIS IP lookup information that includes critical details such as IP address registration, ownership, regional registry, and geographic location. This real-time data is essential for effective IP address management, advanced IP intelligence, and informed decision-making. Ideal for cybersecurity experts, network administrators, and data analysts, our API provides immediate updates to support your IP analysis, enhance cybersecurity measures, and optimize network management.

Structured & Raw WHOIS Data

Our API provides both structured and raw WHOIS IP data directly from regional registries' WHOIS servers. The structured data is neatly organized for easy use, while the raw WHOIS data offers detailed, unprocessed information. This raw data is especially valuable for advanced machine learning models and artificial intelligence applications. Leverage our data to refine your IP management strategies and gain precise, actionable insights.

Documentation

API Endpoint

GET

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

Test

LANGUAGE

Python

PHP

Java

Node

Ruby

$ pip install requests

API Request

Parameter	Required	Type	Default	Description
ip	Yes	String		IPv4 or IPv6 whose WHOIS required

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	Double	Optional	Latitude value parsed from `geoloc` in the inetnum object
longitude	Double	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 orgnasization object

orgnasization.address

List<String>

Mandatory

All values of address in the orgnasization object

orgnasization.street

String

Optional

Parsed street addressfrom address

orgnasization.city

String

Optional

Parsed cityfrom address

orgnasization.district

String

Optional

Parsed districtfrom address

orgnasization.state

String

Optional

Parsed statefrom address

orgnasization.zip_code

String

Optional

Parsed ZIP codefrom address

orgnasization.country

String

Optional

Parsed countryfrom address

orgnasization.latitude

Double

Optional

latitude parsed from the geoloc field

orgnasization.longitude

Double

Optional

longitude parsed from the geoloc field

orgnasization.email

List<String>

Mandatory

All values of email in the orgnasization 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

HTTP Error Codes

HTTP Status	Reasons
400	Request-param 'ip' (<ip>) is not valid.
500	Internal Server error occurred.
503	Service is unavailable.
504	Request is timed-out.

How-To-Guides

Lookup By IPv4 address

To perform a WHOIS IP lookup for IPv4 addresses, include the ip parameter in your request with the specified IPv4 address. The response will also contain raw WHOIS data, offering you detailed and unprocessed information for in-depth IP address analysis. This process ensures you receive comprehensive WHOIS IP lookup data, including key details such as registration, ownership, and geographic location, which is essential for precise IP management and advanced IP intelligence.

curl --location 'https://api.apifreaks.com/v1.0/ip/whois/live?ip=8.8.8.8&apiKey=API-KEY'

{
    "status": true,
    "ip_address": "8.8.8.8",
    "query_time": "2024-08-08 15:14:11",
    "whois_server": "whois.arin.net",
    "inet_nums": [
        {
            "start_ip": "8.8.8.0",
            "end_ip": "8.8.8.255",
            "cidr": [
                "8.8.8.0/24"
            ],
            "net_name": "GOGL",
            "net_handle": "NET-8-8-8-0-2",
            "status": "Direct Allocation",
            "organization": "Google LLC (GOGL)",
            "date_created": "2023-12-28",
            "date_updated": "2023-12-28",
            "source": "https://rdap.arin.net/registry/ip/8.8.8.0",
            "parents": [
                "NET8 (NET-8-0-0-0-0)"
            ]
        }
    ],
    "organization": {
        "handle": "GOGL",
        "name": "Google LLC",
        "address": [
            "1600 Amphitheatre Parkway",
            "Mountain View",
            "CA",
            "94043",
            "US"
        ],
        "street": "Amphitheatre Parkway",
        "city": "Mountain View",
        "state": "CA",
        "zip_code": "94043",
        "country": [
            "US"
        ],
        "date_created": "2000-03-30",
        "date_updated": "2019-10-31",
        "source": "https://rdap.arin.net/registry/entity/GOGL"
    },
    "technical_contacts": [
        {
            "handle": "ZG39-ARIN",
            "name": "Google LLC",
            "email": [
                "arin-contact@google.com"
            ],
            "phone": [
                "+1-650-253-0000"
            ],
            "source": "https://rdap.arin.net/registry/entity/ZG39-ARIN"
        }
    ],
    "abuse_contacts": [
        {
            "handle": "ABUSE5250-ARIN",
            "name": "Abuse",
            "email": [
                "network-abuse@google.com"
            ],
            "phone": [
                "+1-650-253-0000"
            ],
            "source": "https://rdap.arin.net/registry/entity/ABUSE5250-ARIN"
        }
    ],
    "whois_raw_response": "#\n# ARIN WHOIS data and services are subject to the Terms of Use\n# available at: https://www.arin.net/resources/registry/whois/tou/\n#\n# If you see inaccuracies in the results, please report at\n# https://www.arin.net/resources/registry/whois/inaccuracy_reporting/\n#\n# Copyright 1997-2024, American Registry for Internet Numbers, Ltd.\n#\n\n\nNetRange:       8.8.8.0 - 8.8.8.255\nCIDR:           8.8.8.0/24\nNetName:        GOGL\nNetHandle:      NET-8-8-8-0-2\nParent:         NET8 (NET-8-0-0-0-0)\nNetType:        Direct Allocation\nOriginAS:       \nOrganization:   Google LLC (GOGL)\nRegDate:        2023-12-28\nUpdated:        2023-12-28\nRef:            https://rdap.arin.net/registry/ip/8.8.8.0\n\n\n\nOrgName:        Google LLC\nOrgId:          GOGL\nAddress:        1600 Amphitheatre Parkway\nCity:           Mountain View\nStateProv:      CA\nPostalCode:     94043\nCountry:        US\nRegDate:        2000-03-30\nUpdated:        2019-10-31\nComment:        Please note that the recommended way to file abuse complaints are located in the following links. \nComment:        \nComment:        To report abuse and illegal activity: https://www.google.com/contact/\nComment:        \nComment:        For legal requests: http://support.google.com/legal \nComment:        \nComment:        Regards, \nComment:        The Google Team\nRef:            https://rdap.arin.net/registry/entity/GOGL\n\n\nOrgTechHandle: ZG39-ARIN\nOrgTechName:   Google LLC\nOrgTechPhone:  +1-650-253-0000 \nOrgTechEmail:  arin-contact@google.com\nOrgTechRef:    https://rdap.arin.net/registry/entity/ZG39-ARIN\n\nOrgAbuseHandle: ABUSE5250-ARIN\nOrgAbuseName:   Abuse\nOrgAbusePhone:  +1-650-253-0000 \nOrgAbuseEmail:  network-abuse@google.com\nOrgAbuseRef:    https://rdap.arin.net/registry/entity/ABUSE5250-ARIN\n\n\n#\n# ARIN WHOIS data and services are subject to the Terms of Use\n# available at: https://www.arin.net/resources/registry/whois/tou/\n#\n# If you see inaccuracies in the results, please report at\n# https://www.arin.net/resources/registry/whois/inaccuracy_reporting/\n#\n# Copyright 1997-2024, American Registry for Internet Numbers, Ltd.\n#"
}

Lookup By IPv6

Include the ip parameter with the specified IPv6 address in your request to conduct a WHOIS lookup for IPv6 addresses.

curl --location 'https://api.apifreaks.com/v1.0/ip/whois/live?ip=2001%3A4860%3A4860%3A%3A1&apiKey=API-KEY'

{
    "status": true,
    "ip_address": "2001:4860:4860::1",
    "query_time": "2024-08-08 15:27:56",
    "whois_server": "whois.arin.net",
    "inet_nums": [
        {
            "start_ip": "2001:4860::",
            "end_ip": "2001:4860:ffff:ffff:ffff:ffff:ffff:ffff",
            "cidr": [
                "2001:4860::/32"
            ],
            "net_name": "GOOGLE-IPV6",
            "net_handle": "NET6-2001-4860-1",
            "status": "Direct Allocation",
            "organization": "Google LLC (GOGL)",
            "date_created": "2005-03-14",
            "date_updated": "2012-02-24",
            "source": "https://rdap.arin.net/registry/ip/2001:4860::",
            "parents": [
                "ARIN-004 (NET6-2001-4800-0)"
            ]
        }
    ],
    "organization": {
        "handle": "GOGL",
        "name": "Google LLC",
        "address": [
            "1600 Amphitheatre Parkway",
            "Mountain View",
            "CA",
            "94043",
            "US"
        ],
        "street": "Amphitheatre Parkway",
        "city": "Mountain View",
        "state": "CA",
        "zip_code": "94043",
        "country": [
            "US"
        ],
        "date_created": "2000-03-30",
        "date_updated": "2019-10-31",
        "source": "https://rdap.arin.net/registry/entity/GOGL"
    },
    "technical_contacts": [
        {
            "handle": "ZG39-ARIN",
            "name": "Google LLC",
            "email": [
                "arin-contact@google.com"
            ],
            "phone": [
                "+1-650-253-0000"
            ],
            "source": "https://rdap.arin.net/registry/entity/ZG39-ARIN"
        }
    ],
    "abuse_contacts": [
        {
            "handle": "ABUSE5250-ARIN",
            "name": "Abuse",
            "email": [
                "network-abuse@google.com"
            ],
            "phone": [
                "+1-650-253-0000"
            ],
            "source": "https://rdap.arin.net/registry/entity/ABUSE5250-ARIN"
        },
        {
            "handle": "ZG39-ARIN",
            "name": "Google LLC",
            "email": [
                "arin-contact@google.com"
            ],
            "phone": [
                "+1-650-253-0000"
            ],
            "source": "https://rdap.arin.net/registry/entity/ZG39-ARIN"
        }
    ],
    "whois_raw_response": "#
# ARIN WHOIS data and services are subject to the Terms of Use\n# available at: https://www.arin.net/resources/registry/whois/tou/\n#\n# If you see inaccuracies in the results, please report at\n# https://www.arin.net/resources/registry/whois/inaccuracy_reporting/\n#\n# Copyright 1997-2024, American Registry for Internet Numbers, Ltd.\n#\n\n\nNetRange:       2001:4860:: - 2001:4860:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF\nCIDR:           2001:4860::/32\nNetName:        GOOGLE-IPV6\nNetHandle:      NET6-2001-4860-1\nParent:         ARIN-004 (NET6-2001-4800-0)\nNetType:        Direct Allocation\nOriginAS:       AS15169\nOrganization:   Google LLC (GOGL)\nRegDate:        2005-03-14\nUpdated:        2012-02-24\nRef:            https://rdap.arin.net/registry/ip/2001:4860::\n\n\n\nOrgName:        Google LLC\nOrgId:          GOGL\nAddress:        1600 Amphitheatre Parkway\nCity:           Mountain View\nStateProv:      CA\nPostalCode:     94043\nCountry:        US\nRegDate:        2000-03-30\nUpdated:        2019-10-31\nComment:        Please note that the recommended way to file abuse complaints are located in the following links. \nComment:        \nComment:        To report abuse and illegal activity: https://www.google.com/contact/\nComment:        \nComment:        For legal requests: http://support.google.com/legal \nComment:        \nComment:        Regards, \nComment:        The Google Team\nRef:            https://rdap.arin.net/registry/entity/GOGL\n\n\nOrgTechHandle: ZG39-ARIN\nOrgTechName:   Google LLC\nOrgTechPhone:  +1-650-253-0000 \nOrgTechEmail:  arin-contact@google.com\nOrgTechRef:    https://rdap.arin.net/registry/entity/ZG39-ARIN\n\nOrgAbuseHandle: ABUSE5250-ARIN\nOrgAbuseName:   Abuse\nOrgAbusePhone:  +1-650-253-0000 \nOrgAbuseEmail:  network-abuse@google.com\nOrgAbuseRef:    https://rdap.arin.net/registry/entity/ABUSE5250-ARIN\n\nRTechHandle: ZG39-ARIN\nRTechName:   Google LLC\nRTechPhone:  +1-650-253-0000 \nRTechEmail:  arin-contact@google.com\nRTechRef:    https://rdap.arin.net/registry/entity/ZG39-ARIN\n\nRNOCHandle: ZG39-ARIN\nRNOCName:   Google LLC\nRNOCPhone:  +1-650-253-0000 \nRNOCEmail:  arin-contact@google.com\nRNOCRef:    https://rdap.arin.net/registry/entity/ZG39-ARIN\n\nRAbuseHandle: ZG39-ARIN\nRAbuseName:   Google LLC\nRAbusePhone:  +1-650-253-0000 \nRAbuseEmail:  arin-contact@google.com\nRAbuseRef:    https://rdap.arin.net/registry/entity/ZG39-ARIN\n\n\n#\n# ARIN WHOIS data and services are subject to the Terms of Use\n# available at: https://www.arin.net/resources/registry/whois/tou/\n#\n# If you see inaccuracies in the results, please report at\n# https://www.arin.net/resources/registry/whois/inaccuracy_reporting/\n#\n# Copyright 1997-2024, American Registry for Internet Numbers, Ltd.\n#"
}

Pricing

To use the IP WHOIS Lookup API, API credits are required. Charges apply only for successful queries, indicated by a 2xx status code. If a request results in a 4xx or 5xx status code, no credits will be deducted, and any credits previously charged will be refunded.

For each successful request, 15 credits will be charged for WHOIS IP lookup. Utilize the Credits Usage API to efficiently monitor your recent consumption of both one-off and subscription credits. This API provides a streamlined way to track and manage your credit usage, ensuring you stay informed about your remaining balance and can optimize your resource allocation effectively.

WHOIS IP Lookup API - Complete IP Registration and Ownership Details

Features

Support IPv4 and IPv6 Address Space

Real-Time Data

Structured & Raw WHOIS Data

Documentation

API Endpoint

API Request

API Response

HTTP Error Codes

How-To-Guides

Lookup By IPv4 address

Lookup By IPv6

Pricing

Price Estimation Calculator