This REST API enables users to lookup for a domain information, WHOIS record, by using a domain name. The API returns a comprehensive WHOIS data such as creation date, updated date, expiration date, domain age, registrant information and so on. Please see below for the technical details.

Note: The free license key is going to deprecate on 2020-11-31. If you are currently using free as the license key in IP2WHOIS Domain REST API, you are required to sign up for a free account at to continue using our FREE service.




Parameter Description
key (required) API license key.
domain (required) Domain name.


Parameter Description
domain Domain name.
domain_id Domain name ID.
status Domain name status.
create_date Domain name creation date.
update_date Domain name updated date.
expire_date Domain name expiration date.
domain_age Domain name age.
whois_server WHOIS server name.
registrar_iana_id Registrar IANA ID.
registrar_name Registrar name.
registrar_url Registrar URL.
registrant_name Registrant name.
registrant_organization Registrant organization.
registrant_street_address Registrant street address.
registrant_city Registrant city.
registrant_region Registrant region.
registrant_zip_code Registrant ZIP Code.
registrant_country Registrant country.
registrant_phone Registrant phone number.
registrant_fax Registrant fax number.
registrant_email Registrant email address.
admin_name Admin name.
admin_organization Admin organization.
admin_street_address Admin street address.
admin_city Admin city.
admin_region Admin region.
admin_zip_code Admin ZIP Code.
admin_country Admin country.
admin_phone Admin phone number.
admin_fax Admin fax number.
admin_email Admin email address.
tech_name Tech name.
tech_organization Tech organization.
tech_street_address Tech street address.
tech_city Tech city.
tech_region Tech region.
tech_zip_code Tech ZIP Code.
tech_country Tech country.
tech_phone Tech phone number.
tech_fax Tech fax number.
tech_email Tech email address.
billing_name Billing name.
billing_organization Billing organization.
billing_street_address Billing street address.
billing_city Billing city.
billing_region Billing region.
billing_zip_code Billing ZIP Code.
billing_country Billing country.
billing_phone Billing phone number.
billing_fax Billing fax number.
billing_email Billing email address.
name_servers Name servers
error_code Error code in this query.
error_message More information about the error of this query.
GET v1
curl "{your_license_key}&domain={domain_name}"

Sample codes for other languages

    "domain": "",
    "domain_id": "600750_DOMAIN_COM-VRSN",
    "status": "registered",
    "create_date": "1997-11-03T00:00:00Z",
    "update_date": "2019-10-29T01:25:57Z",
    "expire_date": "2021-11-02T05:00:00Z",
    "domain_age": 8103,
    "whois_server": "",
    "registrar": {
        "iana_id": "299",
        "name": "CSC CORPORATE DOMAINS, INC.",
        "url": ""
    "registrant": {
        "name": "Admin Role",
        "organization": "Green Dot Corporation",
        "street_address": "",
        "city": "Pasadena",
        "region": "CA",
        "zip_code": "91107",
        "country": "US",
        "phone": "+1.8664120548",
        "fax": "+1.8664120548",
        "email": ""
    "admin": {
        "name": "Admin Role",
        "organization": "Green Dot Corporation",
        "street_address": "",
        "city": "Pasadena",
        "region": "CA",
        "zip_code": "91107",
        "country": "US",
        "phone": "+1.8664120548",
        "fax": "+1.8664120548",
        "email": ""
    "tech": {
        "name": "Admin Role",
        "organization": "Green Dot Corporation",
        "street_address": "",
        "city": "Pasadena",
        "region": "CA",
        "zip_code": "91107",
        "country": "US",
        "phone": "+1.8664120548",
        "fax": "+1.8664120548",
        "email": ""
    "billing": {
        "name": "",
        "organization": "",
        "street_address": "",
        "city": "",
        "region": "",
        "zip_code": "",
        "country": "",
        "phone": "",
        "fax": "",
        "email": ""
    "nameservers": ",",
    "error_code": "",
    "error_message": ""
Sample Code
$apiKey = 'Enter_License_Key';
$params['domain'] = 'Enter_Domain_Name';

$query = '';

foreach($params as $key=>$value){
    $query .= '&' . $key . '=' . rawurlencode($value);

$result = file_get_contents('' . $apiKey . $query);

$data = json_decode($result);

import java.util.Hashtable;
import java.util.Map;

public class test {
    public static void main(String[] args) {
        try {
            String key = "Enter_License_Key";
            Hashtable<String, String> data = new Hashtable<String, String>();
            data.put("domain", "Enter_Domain_Name");
            String datastr = "";
            for (Map.Entry<String,String> entry : data.entrySet()) {
                datastr += "&" + entry.getKey() + "=" + URLEncoder.encode(entry.getValue(), "UTF-8");
            URL url = new URL("" + key + datastr);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestProperty("Accept", "application/json");
            if (conn.getResponseCode() != 200) {
                throw new RuntimeException("Failed : HTTP error code : " + conn.getResponseCode());
            BufferedReader br = new BufferedReader(new InputStreamReader((conn.getInputStream())));
            String output;
            while ((output = br.readLine()) != null) {
        catch (MalformedURLException e) {
        catch (IOException e) {
Imports System.Net
Imports System.IO
Imports System.Uri

Public Class _Default
    Inherits System.Web.UI.Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
        Dim request As HttpWebRequest = Nothing
        Dim response As HttpWebResponse = Nothing

        Dim apiKey As String = "Enter_License_Key"
        Dim data As New Dictionary(Of String, String)

        data.Add("domain", "Enter_Domain_Name")
        Dim datastr As String = String.Join("&", data.[Select](Function(x) x.Key & "=" & EscapeDataString(x.Value)).ToArray())

        request = Net.WebRequest.Create("" & apiKey & "&" & datastr)

        request.Method = "GET"
        response = request.GetResponse()

        Dim reader As System.IO.StreamReader = New IO.StreamReader(response.GetResponseStream())


    End Sub

End Class
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Net;
using System.IO;

namespace WebApplication1
    public partial class _Default : System.Web.UI.Page
        protected void Page_Load(object sender, EventArgs e)
            WebRequest request = null;
            WebResponse response = null;

            string apiKey = "Enter_License_Key";
            Dictionary<string, string> data = new Dictionary<string, string>();

            data.Add("domain", "Enter_Domain_Name");
            string datastr = string.Join("&", data.Select(x => x.Key + "=" + System.Uri.EscapeDataString(x.Value)).ToArray());

            request = System.Net.WebRequest.Create("" + apiKey + "&" + datastr);

            request.Method = "GET";
            response = request.GetResponse();

            System.IO.StreamReader reader = new System.IO.StreamReader(response.GetResponseStream());

import httplib
import urllib
import hashlib

p = { 'key': 'Enter_License_Key', 'domain': 'Enter_Domain_Name' }

conn = httplib.HTTPConnection("")
conn.request("GET", "/v1?" + urllib.urlencode(p))
res = conn.getresponse()
require 'uri'
require 'net/http'

uri = URI.parse("")
http =, uri.port)
http.use_ssl = true
request =
  'key' => 'Enter_License_Key',
  'domain' => 'Enter_Domain_Name'

response = http.request(request)

if response == nil
  return false
  return response