pricing background

IP Whois API Documentation

IP Whois API Lookup

ASK AI
The IP WHOIS API provides detailed IP address information, including registration data, organization details, administrative, technical, and abuse contacts, as well as routing and network information, all returned in well‑structured JSON or XML format.

Authorization

You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.

Important References

  • For details on request limits and handling rate limiting, refer here
  • For a complete overview of API credit consumption and usage, refer here

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • ip
    IPv4 or IPv6 address for the requested whois.
Optional
  • format
    Two formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Fields Description

Fields
Details
Data Type
Example
status
Indicates whether the WHOIS API request was successful
boolean
true
ip_address
IP address being queried
string
8.8.8.8
query_time
Timestamp when the WHOIS query was executed
string (YYYY-MM-DD HH:mm:ss)
2024-02-01 07:50:47
whois_server
WHOIS server used for IP lookup
string
whois.arin.net
inet_nums
List of IP network allocation records
array
start_ip
Start IP of allocated range
string
8.8.8.0
end_ip
End IP of allocated range
string
8.8.8.255
cidr
CIDR notation of IP range
string
8.8.8.0/24
net_name
Network name
string
GOGL
net_handle
Network handle identifier
string
NET-8-8-8-0-2
status
Allocation status of the IP block
string
Direct Allocation
organization
Organization owning the IP block
string
Google LLC (GOGL)
date_created
Date when IP block was created
string (YYYY-MM-DD)
2023-12-28
date_updated
Last update date of IP block
string (YYYY-MM-DD)
2023-12-28
source
Source RDAP/WHOIS registry URL
string
https://rdap.arin.net/registry/ip/8.8.8.0
parents
Parent network blocks
string
NET8 (NET-8-0-0-0-0)
organization
Organization details associated with IP allocation
handle
Organization handle/ID
string
GOGL
name
Organization name
string
Google LLC
address
Full postal address
string
1600 Amphitheatre Parkway
street
Street name
string
Amphitheatre Parkway
city
City
string
Mountain View
state
State code
string
CA
zip_code
Postal code
string
94043
country
Country code(s)
string
US
date_created
Organization record creation date
string (YYYY-MM-DD)
2000-03-30
date_updated
Last update date of organization record
string (YYYY-MM-DD)
2019-10-31
source
Registry source URL
string
https://rdap.arin.net/registry/entity/GOGL
technical_contacts
Technical contact details for IP allocation
array
handle
Contact handle
string
ZG39-ARIN
name
Contact name
string
Google LLC
email
Contact email addresses
string
[email protected]
phone
Contact phone numbers
string
+1-650-253-0000
source
Registry source URL
string
https://rdap.arin.net/registry/entity/ZG39-ARIN
abuse_contacts
Abuse contact information for reporting misuse
array
handle
Abuse contact handle
string
ABUSE5250-ARIN
name
Abuse contact name
string
Abuse
email
Abuse contact email addresses
string
[email protected]
phone
Abuse contact phone numbers
string
+1-650-253-0000
source
Registry source URL
string
https://rdap.arin.net/registry/entity/ABUSE5250-ARIN
whois_raw_response
Raw WHOIS response data from ARIN
string