Domain WHOIS

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

Returns the current WHOIS registration record of a domain: registrar, registrant, creation, update and expiry dates, name servers and status codes. The record is queried in real time. The response includes both the raw WHOIS text and a parsed version.

Example

Request

curl

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

Python

import requests

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

params = {
    "domain": "deepinfo.com"
}

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/whois?domain=deepinfo.com";

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/whois?domain=deepinfo.com", 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/whois?domain=deepinfo.com"))
            .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/whois?domain=deepinfo.com");
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/whois?domain=deepinfo.com',
    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/whois?domain=deepinfo.com')

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

{
  "domain_name": "deepinfo.com",
  "raw": "Domain Name: DEEPINFO.COM\n   Registry Domain ID: 71858956_DOMAIN_COM-VRSN\n   Registrar WHOIS Server: whois.uniregistrar.com\n   Registrar URL: http://www.uniregistry.com\n   Updated Date: 2025-08-19T07:33:45Z\n   Creation Date: 2001-06-05T02:57:08Z\n   Registry Expiry Date: 2028-10-20T11:59:59Z\n   Registrar: GoDaddy Online Services Cayman Islands Ltd.\n   Registrar IANA ID: 1659\n   Registrar Abuse Contact Email: abuse@uniregistry.com\n   Registrar Abuse Contact Phone: +1 4805058800\n   Domain Status: clientDeleteProhibited https://icann.org/epp#clientDeleteProhibited\n   Domain Status: clientRenewProhibited https://icann.org/epp#clientRenewProhibited\n   Domain Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited\n   Domain Status: clientUpdateProhibited https://icann.org/epp#clientUpdateProhibited\n   Name Server: MAY.NS.CLOUDFLARE.COM\n   Name Server: SIMON.NS.CLOUDFLARE.COM\n   DNSSEC: unsigned\n…",
  "parsed": {
    "uid": "3bafd4dd0782078cdf8163ad780370d9",
    "create_date": "2001-06-05T02:57:08Z",
    "update_date": "2025-08-19T07:33:45Z",
    "expiry_date": "2028-10-20T11:59:59Z",
    "registrar": "godaddy online services cayman islands ltd.",
    "registrant": {
      "name": "registration private",
      "organization": "domains by proxy, llc",
      "street": "domainsbyproxy.com",
      "city": "tempe",
      "state": "arizona",
      "postal_code": "85281",
      "country": "us",
      "phone": "+1.4806242599",
      "email": "https://www.godaddy.com/whois/results.aspx?domain=deepinfo.com&action=contactdomainowner"
    },
    "name_servers": [
      "may.ns.cloudflare.com",
      "simon.ns.cloudflare.com"
    ],
    "domain_status": [
      "clientdeleteprohibited",
      "clientrenewprohibited",
      "clienttransferprohibited",
      "clientupdateprohibited"
    ],
    "whois_server": "whois.uniregistrar.com"
  },
  "check_date": "2026-09-22T12:25:50Z",
  "parse_code": null
}

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

Request

curl

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

Python

import requests

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

params = {
    "domain": "not_a_domain"
}

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/whois?domain=not_a_domain";

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/whois?domain=not_a_domain", 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/whois?domain=not_a_domain"))
            .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/whois?domain=not_a_domain");
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/whois?domain=not_a_domain',
    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/whois?domain=not_a_domain')

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

400 Bad Request · application/json

Response Body

{
  "code": 10400,
  "parameters": [
    {
      "param": "domain",
      "subcode": 10001,
      "details": [
        "Domain extension is not given in the input."
      ]
    }
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}

Content-Type: application/json
ratelimit-limit: 10
ratelimit-remaining: 9
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
`domain`	Required	Domain name, e.g. `deepinfo.com`. Subdomains are accepted (`www.deepinfo.com`); IP addresses are not. Example`deepinfo.com`

Response Fields

Field	Description
`domain_name`	The queried domain
`raw`	Raw WHOIS text as returned by the WHOIS server
`parsed`	Parsed record, with the `parsed.*` fields below. `null` if the record could not be parsed
`parsed.create_date`	Registration date
`parsed.update_date`	Date of the last update
`parsed.expiry_date`	Expiry date
`parsed.registrar`	Registrar
`parsed.registrant.name`	Registrant name
`parsed.registrant.organization`	Registrant organization
`parsed.registrant.street`	Registrant street address
`parsed.registrant.city`	Registrant city
`parsed.registrant.state`	Registrant state or province
`parsed.registrant.postal_code`	Registrant postal code
`parsed.registrant.country`	Registrant country
`parsed.registrant.phone`	Registrant phone number
`parsed.registrant.email`	Registrant e-mail address
`parsed.name_servers`	Name servers
`parsed.domain_status`	Domain status codes
`parsed.whois_server`	WHOIS server
`check_date`	When the lookup was performed (UTC)
`parse_code`	Parser status code; `null` when parsing succeeded

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
`domain_name`	string	`"deepinfo.com"`
`raw`	string
`parsed`	object
`parsed.uid`	string	`"3bafd4dd0782078cdf8163ad780370d9"`
`parsed.create_date`	string	`"2001-06-05T02:57:08Z"`
`parsed.update_date`	string	`"2025-08-19T07:33:45Z"`
`parsed.expiry_date`	string	`"2028-10-20T11:59:59Z"`
`parsed.registrar`	string	`"godaddy online services cayman isla…"`
`parsed.registrant`	object
`parsed.registrant.name`	string
`parsed.registrant.organization`	string
`parsed.registrant.street`	string
`parsed.registrant.city`	string	`"tempe"`
`parsed.registrant.state`	string	`"arizona"`
`parsed.registrant.postal_code`	string
`parsed.registrant.country`	string	`"us"`
`parsed.registrant.phone`	string
`parsed.registrant.email`	string
`parsed.name_servers`	array<string>	`"may.ns.cloudflare.com"`
`parsed.domain_status`	array<string>	`"clientdeleteprohibited"`
`parsed.whois_server`	string	`"whois.uniregistrar.com"`
`check_date`	string	`"2026-09-22T12:25:50Z"`
`parse_code`	null

Errors

400 if domain is missing or not a valid domain. See Getting Started → Errors.

Examples

Saved examples from the Deepinfo API. Selecting one loads it into the request and response panels.

Worked Examples

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

WHOIS for .com (nic.com)The WHOIS record of nic.com, in the .com registry's format.
WHOIS for .org (nic.org)The WHOIS record of nic.org, in the .org registry's format.
WHOIS for .de (nic.de)The WHOIS record of nic.de, in the .de registry's format.
WHOIS for .jp (nic.jp)The WHOIS record of nic.jp, in the .jp registry's format.

See all examples

Reference updated September 27, 2026