IP WHOIS

GEThttps://api.deepinfo.com/v1/lookup/ip-whois

Returns the current registration details of an IP address from the regional internet registries (RDAP/WHOIS): the owning network and its range, the ASN, the registry, and contact entities.

Request

curl

curl 'https://api.deepinfo.com/v1/lookup/ip-whois?ip=8.8.8.8' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'

Python

import requests

url = "https://api.deepinfo.com/v1/lookup/ip-whois"

params = {
    "ip": "8.8.8.8"
}

headers = {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json"
}

response = requests.get(url, params=params, headers=headers)
response.raise_for_status()
print(response.json())

JavaScript

const url = "https://api.deepinfo.com/v1/lookup/ip-whois?ip=8.8.8.8";

const response = await fetch(url, {
  method: "GET",
  headers: {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json"
  },
});

const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.deepinfo.com/v1/lookup/ip-whois?ip=8.8.8.8", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("apikey", "YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(body))
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.deepinfo.com/v1/lookup/ip-whois?ip=8.8.8.8"))
            .header("apikey", "YOUR_API_KEY")
            .header("Accept", "application/json")
            .GET()
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

using System;
using System.Net.Http;

using var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Get, "https://api.deepinfo.com/v1/lookup/ip-whois?ip=8.8.8.8");
request.Headers.Add("apikey", "YOUR_API_KEY");
request.Headers.Add("Accept", "application/json");

using var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.deepinfo.com/v1/lookup/ip-whois?ip=8.8.8.8',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'apikey: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($curl);

if ($response === false) {
    throw new RuntimeException(curl_error($curl));
}

echo $response . PHP_EOL;

Ruby

require 'net/http'
require 'uri'

uri = URI('https://api.deepinfo.com/v1/lookup/ip-whois?ip=8.8.8.8')

request = Net::HTTP::Get.new(uri)
request['apikey'] = 'YOUR_API_KEY'
request['Accept'] = 'application/json'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Response

200 OK · application/json

Response Body

{
  "ip": "8.8.8.8",
  "ipwhois": {
    "asn": "15169",
    "asn_cidr": "8.8.8.0/24",
    "asn_description": "GOOGLE - Google LLC, US",
    "asn_country_code": "US",
    "asn_registry": "arin",
    "entities": [
      "GOGL"
    ],
    "asn_date": "2023-12-28",
    "nir": null,
    "query": "8.8.8.8",
    "raw": null,
    "network": {
      "cidr": "8.8.8.0/24",
      "name": "GOGL",
      "country": null,
      "start_address": "8.8.8.0",
      "end_address": "8.8.8.255",
      "handle": "NET-8-8-8-0-2",
      "ip_version": "v4",
      "links": [
        "https://rdap.arin.net/registry/ip/8.8.8.0",
        "https://whois.arin.net/rest/net/NET-8-8-8-0-2"
      ],
      "parent_handle": "NET-8-0-0-0-0",
      "raw": null,
      "status": [
        "active"
      ],
      "type": "DIRECT ALLOCATION",
      "notices": [
        {
          "title": "Terms of Service",
          "description": "By using the ARIN RDAP/Whois service, you are agreeing to the RDAP/Whois Terms of Use",
          "links": [
            "https://www.arin.net/resources/registry/whois/tou/"
          ]
        },
        {
          "title": "Whois Inaccuracy Reporting",
          "description": "If you see inaccuracies in the results, please visit: ",
          "links": [
            "https://www.arin.net/resources/registry/whois/inaccuracy_reporting/"
          ]
        }
      ],
      "remarks": null,
      "events": [
        {
          "action": "last changed",
          "actor": null,
          "timestamp": "2023-12-28T22:24:56Z"
        },
        {
          "action": "registration",
          "actor": null,
          "timestamp": "2023-12-28T22:24:33Z"
        }
      ]
    },
    "objects": {
      "GOGL": {
        "contact": {
          "email": null,
          "address": [
            {
              "type": null,
              "value": "1600 Amphitheatre Parkway\nMountain View\nCA\n94043\nUnited States"
            }
          ],
          "phone": null,
          "kind": "org",
          "name": "Google LLC",
          "role": null,
          "title": null
        },
        "entities": [
          "ABUSE5250-ARIN",
          "ZG39-ARIN"
        ],
        "events": [
          {
            "action": "last changed",
            "actor": null,
            "timestamp": "2019-10-31T19:45:45Z"
          },
          {
            "action": "registration",
            "actor": null,
            "timestamp": "2000-03-30T05:00:00Z"
          }
        ],
        "events_actor": null,
        "handle": "GOGL",
        "links": [
          "https://rdap.arin.net/registry/entity/GOGL",
          "https://whois.arin.net/rest/org/GOGL"
        ],
        "notices": null,
        "raw": null,
        "remarks": [
          {
            "title": "Registration Comments",
            "description": "Please note that the recommended way to file abuse complaints are located in the following links. \n\nTo report abuse and illegal activity: https://www.google.com/contact/\n\nFor legal requests: http://support.google.com/legal \n\nRegards, \nThe Google Team",
            "links": null
          }
        ],
        "roles": [
          "registrant"
        ],
        "status": null
      },
      "ABUSE5250-ARIN": {
        "contact": {
          "email": [
            {
              "type": null,
              "value": "network-abuse@google.com"
            }
          ],
          "address": [
            {
              "type": null,
              "value": "1600 Amphitheatre Parkway\nMountain View\nCA\n94043\nUnited States"
            }
          ],
          "phone": [
            {
              "type": [
                "work",
                "voice"
              ],
              "value": "+1-650-253-0000"
            }
          ],
          "kind": "group",
          "name": "Abuse",
          "role": null,
          "title": null
        },
        "entities": null,
        "events": [
          {
            "action": "last changed",
            "actor": null,
            "timestamp": "2026-08-19T18:34:18Z"
          },
          {
            "action": "registration",
            "actor": null,
            "timestamp": "2015-11-06T20:36:35Z"
          }
        ],
        "events_actor": null,
        "handle": "ABUSE5250-ARIN",
        "links": [
          "https://rdap.arin.net/registry/entity/ABUSE5250-ARIN",
          "https://whois.arin.net/rest/poc/ABUSE5250-ARIN"
        ],
        "notices": [
          {
            "title": "Terms of Service",
            "description": "By using the ARIN RDAP/Whois service, you are agreeing to the RDAP/Whois Terms of Use",
            "links": [
              "https://www.arin.net/resources/registry/whois/tou/"
            ]
          },
          {
            "title": "Whois Inaccuracy Reporting",
            "description": "If you see inaccuracies in the results, please visit: ",
            "links": [
              "https://www.arin.net/resources/registry/whois/inaccuracy_reporting/"
            ]
          }
        ],
        "raw": null,
        "remarks": [
          {
            "title": "Registration Comments",
            "description": "Please note that the recommended way to file abuse complaints are located in the following links.\n\nTo report abuse and illegal activity: https://www.google.com/contact/\n\nFor legal requests: http://support.google.com/legal \n\nRegards,\nThe Google Team",
            "links": null
          }
        ],
        "roles": [
          "abuse"
        ],
        "status": [
          "validated"
        ]
      },
      "ZG39-ARIN": {
        "contact": {
          "email": [
            {
              "type": null,
              "value": "arin-contact@google.com"
            }
          ],
          "address": [
            {
              "type": null,
              "value": "1600 Amphitheatre Parkway\nMountain View\nCA\n94043\nUnited States"
            }
          ],
          "phone": [
            {
              "type": [
                "work",
                "voice"
              ],
              "value": "+1-650-253-0000"
            }
          ],
          "kind": "group",
          "name": "Google LLC",
          "role": null,
          "title": null
        },
        "entities": null,
        "events": [
          {
            "action": "last changed",
            "actor": null,
            "timestamp": "2025-11-10T12:10:31Z"
          },
          {
            "action": "registration",
            "actor": null,
            "timestamp": "2000-11-30T18:54:08Z"
          }
        ],
        "events_actor": null,
        "handle": "ZG39-ARIN",
        "links": [
          "https://rdap.arin.net/registry/entity/ZG39-ARIN",
          "https://whois.arin.net/rest/poc/ZG39-ARIN"
        ],
        "notices": [
          {
            "title": "Terms of Service",
            "description": "By using the ARIN RDAP/Whois service, you are agreeing to the RDAP/Whois Terms of Use",
            "links": [
              "https://www.arin.net/resources/registry/whois/tou/"
            ]
          },
          {
            "title": "Whois Inaccuracy Reporting",
            "description": "If you see inaccuracies in the results, please visit: ",
            "links": [
              "https://www.arin.net/resources/registry/whois/inaccuracy_reporting/"
            ]
          }
        ],
        "raw": null,
        "remarks": null,
        "roles": [
          "administrative",
          "technical"
        ],
        "status": [
          "validated"
        ]
      }
    }
  },
  "check_date": "2026-09-22T12:26:00Z"
}

Content-Type: application/json
ratelimit-limit: 1
ratelimit-remaining: 0
ratelimit-reset: 1
deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a

Authentication

Send your API key in the apikey request header.

Query Parameters

Parameter	Required	Description
`ip`	Required	IPv4 or IPv6 address. Example`8.8.8.8`

Response Fields

Field	Description
`ip`	The queried IP address
`ipwhois.asn`	Number of the autonomous system (AS) that announces the IP
`ipwhois.asn_cidr`	The announced IP range that contains the IP
`ipwhois.asn_description`	Name of the AS
`ipwhois.asn_country_code`	Country code of the AS
`ipwhois.asn_registry`	Regional internet registry of the AS
`ipwhois.asn_date`	Allocation date of the AS
`ipwhois.network`	The registered network that contains the IP, with the `ipwhois.network.*` fields below
`ipwhois.network.cidr`	Network range in CIDR notation
`ipwhois.network.name`	Network name
`ipwhois.network.country`	Country of the network
`ipwhois.network.start_address`	First address of the range
`ipwhois.network.end_address`	Last address of the range
`ipwhois.network.ip_version`	IP version, e.g. `v4`
`ipwhois.network.handle`	Registry handle of the network
`ipwhois.network.parent_handle`	Handle of the parent network
`ipwhois.network.type`	Allocation type
`ipwhois.network.status`	Registration status
`ipwhois.network.events[]`	Registration events of the network
`ipwhois.network.events[].action`	What happened, e.g. `registration`
`ipwhois.network.events[].actor`	Who did it, when the registry says
`ipwhois.network.events[].timestamp`	When it happened (UTC)
`ipwhois.network.notices[]`	Registry notices
`ipwhois.network.notices[].title`	Notice title
`ipwhois.network.notices[].description`	Notice text
`ipwhois.network.notices[].links`	Links given with the notice
`ipwhois.network.remarks[]`	Registry remarks
`ipwhois.network.remarks[].title`	Remark title
`ipwhois.network.remarks[].description`	Remark text
`ipwhois.network.remarks[].links`	Links given with the remark
`ipwhois.network.links`	RDAP and WHOIS links for the network
`ipwhois.network.raw`	Raw registry answer for the network, when available
`ipwhois.entities`	Handles of related entities (organizations, contacts)
`ipwhois.objects`	Details for each entity handle, keyed by the handle: contact details, roles and registration events
`ipwhois.nir`	National Internet Registry data, where applicable
`check_date`	When the lookup was performed (UTC)

Response Schema

Inferred from examples Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract.

Field	Type	Example
`ip`	string	`"8.8.8.8"`
`ipwhois`	object
`ipwhois.asn`	string	`"15169"`
`ipwhois.asn_cidr`	string	`"8.8.8.0/24"`
`ipwhois.asn_description`	string	`"GOOGLE - Google LLC, US"`
`ipwhois.asn_country_code`	string	`"US"`
`ipwhois.asn_registry`	string	`"arin"`
`ipwhois.entities`	array<string>	`"GOGL"`
`ipwhois.asn_date`	string	`"2023-12-28"`
`ipwhois.nir`	null
`ipwhois.query`	string	`"8.8.8.8"`
`ipwhois.raw`	null
`ipwhois.network`	object
`ipwhois.network.cidr`	string	`"8.8.8.0/24"`
`ipwhois.network.name`	string	`"GOGL"`
`ipwhois.network.country`	null
`ipwhois.network.start_address`	string	`"8.8.8.0"`
`ipwhois.network.end_address`	string	`"8.8.8.255"`
`ipwhois.network.handle`	string	`"NET-8-8-8-0-2"`
`ipwhois.network.ip_version`	string	`"v4"`
`ipwhois.network.links`	array<string>	`"https://rdap.arin.net/registry/ip/8…"`
`ipwhois.network.parent_handle`	string	`"NET-8-0-0-0-0"`
`ipwhois.network.raw`	null
`ipwhois.network.status`	array<string>	`"active"`
`ipwhois.network.type`	string	`"DIRECT ALLOCATION"`
`ipwhois.network.notices`	array<object>
`ipwhois.network.notices[].title`	string	`"Terms of Service"`
`ipwhois.network.notices[].description`	string	`"By using the ARIN RDAP/Whois servic…"`
`ipwhois.network.notices[].links`	array<string>	`"https://www.arin.net/resources/regi…"`
`ipwhois.network.remarks`	null
`ipwhois.network.events`	array<object>
`ipwhois.network.events[].action`	string	`"last changed"`
`ipwhois.network.events[].actor`	null
`ipwhois.network.events[].timestamp`	string	`"2023-12-28T22:24:56Z"`
`ipwhois.objects`	object
`ipwhois.objects.GOGL`	object
`ipwhois.objects.GOGL.contact`	object
`ipwhois.objects.GOGL.contact.email`	null
`ipwhois.objects.GOGL.contact.address`	array<object>
`ipwhois.objects.GOGL.contact.address[].type`	null
`ipwhois.objects.GOGL.contact.address[].value`	string
`ipwhois.objects.GOGL.contact.phone`	null
`ipwhois.objects.GOGL.contact.kind`	string	`"org"`
`ipwhois.objects.GOGL.contact.name`	string
`ipwhois.objects.GOGL.contact.role`	null
`ipwhois.objects.GOGL.contact.title`	null
`ipwhois.objects.GOGL.entities`	array<string>	`"ABUSE5250-ARIN"`
`ipwhois.objects.GOGL.events`	array<object>
`ipwhois.objects.GOGL.events[].action`	string	`"last changed"`
`ipwhois.objects.GOGL.events[].actor`	null
`ipwhois.objects.GOGL.events[].timestamp`	string	`"2019-10-31T19:45:45Z"`
`ipwhois.objects.GOGL.events_actor`	null
`ipwhois.objects.GOGL.handle`	string	`"GOGL"`
`ipwhois.objects.GOGL.links`	array<string>	`"https://rdap.arin.net/registry/enti…"`
`ipwhois.objects.GOGL.notices`	null
`ipwhois.objects.GOGL.raw`	null
`ipwhois.objects.GOGL.remarks`	array<object>
`ipwhois.objects.GOGL.remarks[].title`	string	`"Registration Comments"`
`ipwhois.objects.GOGL.remarks[].description`	string	`"Please note that the recommended wa…"`
`ipwhois.objects.GOGL.remarks[].links`	null
`ipwhois.objects.GOGL.roles`	array<string>	`"registrant"`
`ipwhois.objects.GOGL.status`	null
`ipwhois.objects.ABUSE5250-ARIN`	object
`ipwhois.objects.ABUSE5250-ARIN.contact`	object
`ipwhois.objects.ABUSE5250-ARIN.contact.email`	array<object>
`ipwhois.objects.ABUSE5250-ARIN.contact.email[].type`	null
`ipwhois.objects.ABUSE5250-ARIN.contact.email[].value`	string
`ipwhois.objects.ABUSE5250-ARIN.contact.address`	array<object>
`ipwhois.objects.ABUSE5250-ARIN.contact.address[].type`	null
`ipwhois.objects.ABUSE5250-ARIN.contact.address[].value`	string
`ipwhois.objects.ABUSE5250-ARIN.contact.phone`	array<object>
`ipwhois.objects.ABUSE5250-ARIN.contact.phone[].type`	array<string>
`ipwhois.objects.ABUSE5250-ARIN.contact.phone[].value`	string
`ipwhois.objects.ABUSE5250-ARIN.contact.kind`	string	`"group"`
`ipwhois.objects.ABUSE5250-ARIN.contact.name`	string
`ipwhois.objects.ABUSE5250-ARIN.contact.role`	null
`ipwhois.objects.ABUSE5250-ARIN.contact.title`	null
`ipwhois.objects.ABUSE5250-ARIN.entities`	null
`ipwhois.objects.ABUSE5250-ARIN.events`	array<object>
`ipwhois.objects.ABUSE5250-ARIN.events[].action`	string	`"last changed"`
`ipwhois.objects.ABUSE5250-ARIN.events[].actor`	null
`ipwhois.objects.ABUSE5250-ARIN.events[].timestamp`	string	`"2026-08-19T18:34:18Z"`
`ipwhois.objects.ABUSE5250-ARIN.events_actor`	null
`ipwhois.objects.ABUSE5250-ARIN.handle`	string	`"ABUSE5250-ARIN"`
`ipwhois.objects.ABUSE5250-ARIN.links`	array<string>	`"https://rdap.arin.net/registry/enti…"`
`ipwhois.objects.ABUSE5250-ARIN.notices`	array<object>
`ipwhois.objects.ABUSE5250-ARIN.notices[].title`	string	`"Terms of Service"`
`ipwhois.objects.ABUSE5250-ARIN.notices[].description`	string	`"By using the ARIN RDAP/Whois servic…"`
`ipwhois.objects.ABUSE5250-ARIN.notices[].links`	array<string>	`"https://www.arin.net/resources/regi…"`
`ipwhois.objects.ABUSE5250-ARIN.raw`	null
`ipwhois.objects.ABUSE5250-ARIN.remarks`	array<object>
`ipwhois.objects.ABUSE5250-ARIN.remarks[].title`	string	`"Registration Comments"`
`ipwhois.objects.ABUSE5250-ARIN.remarks[].description`	string	`"Please note that the recommended wa…"`
`ipwhois.objects.ABUSE5250-ARIN.remarks[].links`	null
`ipwhois.objects.ABUSE5250-ARIN.roles`	array<string>	`"abuse"`
`ipwhois.objects.ABUSE5250-ARIN.status`	array<string>	`"validated"`
`ipwhois.objects.ZG39-ARIN`	object
`ipwhois.objects.ZG39-ARIN.contact`	object
`ipwhois.objects.ZG39-ARIN.contact.email`	array<object>
`ipwhois.objects.ZG39-ARIN.contact.email[].type`	null
`ipwhois.objects.ZG39-ARIN.contact.email[].value`	string
`ipwhois.objects.ZG39-ARIN.contact.address`	array<object>
`ipwhois.objects.ZG39-ARIN.contact.address[].type`	null
`ipwhois.objects.ZG39-ARIN.contact.address[].value`	string
`ipwhois.objects.ZG39-ARIN.contact.phone`	array<object>
`ipwhois.objects.ZG39-ARIN.contact.phone[].type`	array<string>
`ipwhois.objects.ZG39-ARIN.contact.phone[].value`	string
`ipwhois.objects.ZG39-ARIN.contact.kind`	string	`"group"`
`ipwhois.objects.ZG39-ARIN.contact.name`	string
`ipwhois.objects.ZG39-ARIN.contact.role`	null
`ipwhois.objects.ZG39-ARIN.contact.title`	null
`ipwhois.objects.ZG39-ARIN.entities`	null
`ipwhois.objects.ZG39-ARIN.events`	array<object>
`ipwhois.objects.ZG39-ARIN.events[].action`	string	`"last changed"`
`ipwhois.objects.ZG39-ARIN.events[].actor`	null
`ipwhois.objects.ZG39-ARIN.events[].timestamp`	string	`"2025-11-10T12:10:31Z"`
`ipwhois.objects.ZG39-ARIN.events_actor`	null
`ipwhois.objects.ZG39-ARIN.handle`	string	`"ZG39-ARIN"`
`ipwhois.objects.ZG39-ARIN.links`	array<string>	`"https://rdap.arin.net/registry/enti…"`
`ipwhois.objects.ZG39-ARIN.notices`	array<object>
`ipwhois.objects.ZG39-ARIN.notices[].title`	string	`"Terms of Service"`
`ipwhois.objects.ZG39-ARIN.notices[].description`	string	`"By using the ARIN RDAP/Whois servic…"`
`ipwhois.objects.ZG39-ARIN.notices[].links`	array<string>	`"https://www.arin.net/resources/regi…"`
`ipwhois.objects.ZG39-ARIN.raw`	null
`ipwhois.objects.ZG39-ARIN.remarks`	null
`ipwhois.objects.ZG39-ARIN.roles`	array<string>	`"administrative"`
`ipwhois.objects.ZG39-ARIN.status`	array<string>	`"validated"`
`check_date`	string	`"2026-09-22T12:26:00Z"`

Errors

400 if ip is not a valid IP address.

Examples

The saved example from the Deepinfo API, shown in the request and response panels.

8.8.8.8GET/lookup/ip-whois?ip=8.8.8.8200 OK

Worked Examples

Worked examples of this endpoint, each on its own page with the exact request and the response it returns.

Google Public DNS (ARIN)IP WHOIS of 8.8.8.8 (ARIN): AS15169 Google, network 8.8.8.0/24, with Google LLC as registrant and its abuse contact.
Cloudflare DNS (APNIC)IP WHOIS of 1.1.1.1 (APNIC): announced by Cloudflare (AS13335) but registered to APNIC Research and Development.
Yandex DNS (RIPE NCC)IP WHOIS of 77.88.8.8 (RIPE NCC): Yandex DNS, two ASNs in one field and no ASN description.
A Brazilian DNS Server (LACNIC)IP WHOIS of 200.160.0.10 (LACNIC): NIC.br's network 200.160.0.0/20, identified by a Brazilian company number.

See all examples

Reference updated September 27, 2026