Domain WHOIS Lookup API - Well-Structured Registration & Ownership Data

API Endpoint

$ pip install requests

API Request

API Response

For a comprehensive view of the API response structure and detailed field descriptions, explore the interactive Response Table by clicking here.

HTTP Status Codes

WHOIS Lookup by Domain Name

To retrieve WHOIS information using a domain name, simply pass the domainName parameter in your API request. If you query a sub-domain, such as 'api.apifreaks.com', our API will return the WHOIS data for the root domain name, 'apifreaks.com', as sub-domains do not have their own WHOIS records and rely on the root domain's data.

When querying a second-level domain (SLD), like 'uet.edu.pk', the API will provide WHOIS information specific to that SLD. SLDs typically consist of three letters, such as 'edu', and are managed by separate registries with their own WHOIS servers. Therefore, for domains like 'uet.edu.pk', the WHOIS response will pertain to'uet.edu.pk' itself rather than the parent domain 'edu.pk'.

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

{
    "status": true,
    "domain_name": "apifreaks.com",
    "query_time": "2024-08-08 12:56:45",
    "whois_server": "whois.verisign-grs.com",
    "domain_registered": "yes",
    "create_date": "2018-11-11",
    "update_date": "2024-04-30",
    "expiry_date": "2024-11-11",
    "domain_registrar": {
        "iana_id": "1068",
        "registrar_name": "NAMECHEAP INC",
        "whois_server": "whois.namecheap.com",
        "website_url": "http://www.namecheap.com",
        "email_address": "abuse@namecheap.com",
        "phone_number": "+1.9854014545"
    },
    "reseller_contact": {
        "name": "NAMECHEAP INC"
    },
    "registrant_contact": {
        "name": "Redacted for Privacy",
        "company": "Privacy service provided by Withheld for Privacy ehf",
        "street": "Kalkofnsvegur 2",
        "city": "Reykjavik",
        "state": "Capital Region",
        "zip_code": "101",
        "country_name": "Iceland",
        "country_code": "IS",
        "email_address": "f736978976114b4ab0741e9ecf2a6a63.protect@withheldforprivacy.com",
        "phone": "+354.4212434"
    },
    "administrative_contact": {
        "name": "Redacted for Privacy",
        "company": "Privacy service provided by Withheld for Privacy ehf",
        "street": "Kalkofnsvegur 2",
        "city": "Reykjavik",
        "state": "Capital Region",
        "zip_code": "101",
        "country_name": "Iceland",
        "country_code": "IS",
        "email_address": "f736978976114b4ab0741e9ecf2a6a63.protect@withheldforprivacy.com",
        "phone": "+354.4212434"
    },
    "technical_contact": {
        "name": "Redacted for Privacy",
        "company": "Privacy service provided by Withheld for Privacy ehf",
        "street": "Kalkofnsvegur 2",
        "city": "Reykjavik",
        "state": "Capital Region",
        "zip_code": "101",
        "country_name": "Iceland",
        "country_code": "IS",
        "email_address": "f736978976114b4ab0741e9ecf2a6a63.protect@withheldforprivacy.com",
        "phone": "+354.4212434"
    },
    "name_servers": [
        "cheryl.ns.cloudflare.com",
        "nash.ns.cloudflare.com"
    ],
    "domain_status": [
        "clientTransferProhibited"
    ],
    "whois_raw_domain": "\nDomain name: apifreaks.com\nRegistry Domain ID: 2331617129_DOMAIN_COM-VRSN\nRegistrar WHOIS Server: whois.namecheap.com\nRegistrar URL: http://www.namecheap.com\nUpdated Date: 2023-10-12T05:53:36.24Z\nCreation Date: 2018-11-11T11:49:12.00Z\nRegistrar Registration Expiration Date: 2024-11-11T11:49:12.00Z\nRegistrar: NAMECHEAP INC\nRegistrar IANA ID: 1068\nRegistrar Abuse Contact Email: abuse@namecheap.com\nRegistrar Abuse Contact Phone: +1.9854014545\nReseller: NAMECHEAP INC\nDomain Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited\nRegistry Registrant ID: \nRegistrant Name: Redacted for Privacy\nRegistrant Organization: Privacy service provided by Withheld for Privacy ehf\nRegistrant Street: Kalkofnsvegur 2 \nRegistrant City: Reykjavik\nRegistrant State/Province: Capital Region\nRegistrant Postal Code: 101\nRegistrant Country: IS\nRegistrant Phone: +354.4212434\nRegistrant Phone Ext: \nRegistrant Fax: \nRegistrant Fax Ext: \nRegistrant Email: f736978976114b4ab0741e9ecf2a6a63.protect@withheldforprivacy.com\nRegistry Admin ID: \nAdmin Name: Redacted for Privacy\nAdmin Organization: Privacy service provided by Withheld for Privacy ehf\nAdmin Street: Kalkofnsvegur 2 \nAdmin City: Reykjavik\nAdmin State/Province: Capital Region\nAdmin Postal Code: 101\nAdmin Country: IS\nAdmin Phone: +354.4212434\nAdmin Phone Ext: \nAdmin Fax: \nAdmin Fax Ext: \nAdmin Email: f736978976114b4ab0741e9ecf2a6a63.protect@withheldforprivacy.com\nRegistry Tech ID: \nTech Name: Redacted for Privacy\nTech Organization: Privacy service provided by Withheld for Privacy ehf\nTech Street: Kalkofnsvegur 2 \nTech City: Reykjavik\nTech State/Province: Capital Region\nTech Postal Code: 101\nTech Country: IS\nTech Phone: +354.4212434\nTech Phone Ext: \nTech Fax: \nTech Fax Ext: \nTech Email: f736978976114b4ab0741e9ecf2a6a63.protect@withheldforprivacy.com\nName Server: cheryl.ns.cloudflare.com\nName Server: nash.ns.cloudflare.com\nDNSSEC: unsigned\nURL of the ICANN WHOIS Data Problem Reporting System: http://wdprs.internic.net/\n>>> Last update of WHOIS database: 2024-08-07T16:56:13.14Z <<<\nFor more information on Whois status codes, please visit https://icann.org/epp",
    "registry_data": {
        "domain_name": "APIFREAKS.COM",
        "query_time": "2024-08-08 12:55:55",
        "whois_server": "whois.verisign-grs.com",
        "domain_registered": "yes",
        "domain_registrar": {
            "iana_id": "1068",
            "registrar_name": "NameCheap, Inc.",
            "whois_server": "whois.namecheap.com",
            "website_url": "http://www.namecheap.com",
            "email_address": "abuse@namecheap.com",
            "phone_number": "+1.6613102107"
        },
        "name_servers": [
            "cheryl.ns.cloudflare.com",
            "nash.ns.cloudflare.com"
        ],
        "domain_status": [
            "clientTransferProhibited"
        ],
        "whois_raw_registery": "\n   Domain Name: APIFREAKS.COM\n   Registry Domain ID: 2331617129_DOMAIN_COM-VRSN\n   Registrar WHOIS Server: whois.namecheap.com\n   Registrar URL: http://www.namecheap.com\n   Updated Date: 2024-04-30T11:03:18Z\n   Creation Date: 2018-11-11T11:49:12Z\n   Registry Expiry Date: 2024-11-11T11:49:12Z\n   Registrar: NameCheap, Inc.\n   Registrar IANA ID: 1068\n   Registrar Abuse Contact Email: abuse@namecheap.com\n   Registrar Abuse Contact Phone: +1.6613102107\n   Domain Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited\n   Name Server: CHERYL.NS.CLOUDFLARE.COM\n   Name Server: NASH.NS.CLOUDFLARE.COM\n   DNSSEC: unsigned\n   URL of the ICANN Whois Inaccuracy Complaint Form: https://www.icann.org/wicf/\n>>> Last update of whois database: 2024-08-08T12:55:45Z <<<\n\nFor more information on Whois status codes, please visit https://icann.org/epp\n\nNOTICE: The expiration date displayed in this record is the date the\nregistrar's sponsorship of the domain name registration in the registry is\ncurrently set to expire. This date does not necessarily reflect the expiration\ndate of the domain name registrant's agreement with the sponsoring\nregistrar.  Users may consult the sponsoring registrar's Whois database to\nview the registrar's reported date of expiration for this registration.\n\nTERMS OF USE: You are not authorized to access or query our Whois\ndatabase through the use of electronic processes that are high-volume and\nautomated except as reasonably necessary to register domain names or\nmodify existing registrations; the Data in VeriSign Global Registry\nServices' ("VeriSign") Whois database is provided by VeriSign for\ninformation purposes only, and to assist persons in obtaining information\nabout or related to a domain name registration record. VeriSign does not\nguarantee its accuracy. By submitting a Whois query, you agree to abide\nby the following terms of use: You agree that you may use this Data only\nfor lawful purposes and that under no circumstances will you use this Data\nto: (1) allow, enable, or otherwise support the transmission of mass\nunsolicited, commercial advertising or solicitations via e-mail, telephone,\nor facsimile; or (2) enable high volume, automated, electronic processes\nthat apply to VeriSign (or its computer systems). The compilation,\nrepackaging, dissemination or other use of this Data is expressly\nprohibited without the prior written consent of VeriSign. You agree not to\nuse electronic processes that are automated and high-volume to access or\nquery the Whois database except as reasonably necessary to register\ndomain names or modify existing registrations. VeriSign reserves the right\nto restrict your access to the Whois database in its sole discretion to ensure\noperational stability.  VeriSign may restrict or terminate your access to the\nWhois database for failure to abide by these terms of use. VeriSign\nreserves the right to modify these terms at any time.\n\nThe Registry database contains ONLY .COM, .NET, .EDU domains and\nRegistrars."
    }
}

In the WHOIS response, you will notice two types of data: registry data and registrar data. For TLDs like {.}com and {.}.net, both registries and registrars maintain their own WHOIS servers. As a result, the API provides WHOIS information from both sources, giving you a comprehensive view of domain details.

Additionally, the WHOIS raw response is included in the output. This raw data reflects the information queried from both the registrar and registry WHOIS servers, ensuring you have access to the complete and unprocessed WHOIS records.

WHOIS Lookup by URL

You can also retrieve WHOIS information by passing a URL to the API. Our system will automatically extract the domain name from the URL you provide and use it to fetch the necessary WHOIS data. This allows you to easily obtain domain details without needing to manually extract the domain name yourself.

curl --location 'https://api.apifreaks.com/v1.0/domain/whois/live?domainName=https%3A%2F%2Fapifreaks.com&apiKey=API-KEY'

{
    "status": true,
    "domain_name": "apifreaks.com",
    "query_time": "2024-08-08 13:05:35",
    "whois_server": "whois.verisign-grs.com",
    "domain_registered": "yes",
    "create_date": "2018-11-11",
    "update_date": "2024-04-30",
    "expiry_date": "2024-11-11",
    "domain_registrar": {
        "iana_id": "1068",
        "registrar_name": "NAMECHEAP INC",
        "whois_server": "whois.namecheap.com",
        "website_url": "http://www.namecheap.com",
        "email_address": "abuse@namecheap.com",
        "phone_number": "+1.9854014545"
    },
    "reseller_contact": {
        "name": "NAMECHEAP INC"
    },
    "registrant_contact": {
        "name": "Redacted for Privacy",
        "company": "Privacy service provided by Withheld for Privacy ehf",
        "street": "Kalkofnsvegur 2",
        "city": "Reykjavik",
        "state": "Capital Region",
        "zip_code": "101",
        "country_name": "Iceland",
        "country_code": "IS",
        "email_address": "f736978976114b4ab0741e9ecf2a6a63.protect@withheldforprivacy.com",
        "phone": "+354.4212434"
    },
    "administrative_contact": {
        "name": "Redacted for Privacy",
        "company": "Privacy service provided by Withheld for Privacy ehf",
        "street": "Kalkofnsvegur 2",
        "city": "Reykjavik",
        "state": "Capital Region",
        "zip_code": "101",
        "country_name": "Iceland",
        "country_code": "IS",
        "email_address": "f736978976114b4ab0741e9ecf2a6a63.protect@withheldforprivacy.com",
        "phone": "+354.4212434"
    },
    "technical_contact": {
        "name": "Redacted for Privacy",
        "company": "Privacy service provided by Withheld for Privacy ehf",
        "street": "Kalkofnsvegur 2",
        "city": "Reykjavik",
        "state": "Capital Region",
        "zip_code": "101",
        "country_name": "Iceland",
        "country_code": "IS",
        "email_address": "f736978976114b4ab0741e9ecf2a6a63.protect@withheldforprivacy.com",
        "phone": "+354.4212434"
    },
    "name_servers": [
        "cheryl.ns.cloudflare.com",
        "nash.ns.cloudflare.com"
    ],
    "domain_status": [
        "clientTransferProhibited"
    ],
    "whois_raw_domain": "\nDomain name: apifreaks.com\nRegistry Domain ID: 2331617129_DOMAIN_COM-VRSN\nRegistrar WHOIS Server: whois.namecheap.com\nRegistrar URL: http://www.namecheap.com\nUpdated Date: 2023-10-12T05:53:36.24Z\nCreation Date: 2018-11-11T11:49:12.00Z\nRegistrar Registration Expiration Date: 2024-11-11T11:49:12.00Z\nRegistrar: NAMECHEAP INC\nRegistrar IANA ID: 1068\nRegistrar Abuse Contact Email: abuse@namecheap.com\nRegistrar Abuse Contact Phone: +1.9854014545\nReseller: NAMECHEAP INC\nDomain Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited\nRegistry Registrant ID: \nRegistrant Name: Redacted for Privacy\nRegistrant Organization: Privacy service provided by Withheld for Privacy ehf\nRegistrant Street: Kalkofnsvegur 2 \nRegistrant City: Reykjavik\nRegistrant State/Province: Capital Region\nRegistrant Postal Code: 101\nRegistrant Country: IS\nRegistrant Phone: +354.4212434\nRegistrant Phone Ext: \nRegistrant Fax: \nRegistrant Fax Ext: \nRegistrant Email: f736978976114b4ab0741e9ecf2a6a63.protect@withheldforprivacy.com\nRegistry Admin ID: \nAdmin Name: Redacted for Privacy\nAdmin Organization: Privacy service provided by Withheld for Privacy ehf\nAdmin Street: Kalkofnsvegur 2 \nAdmin City: Reykjavik\nAdmin State/Province: Capital Region\nAdmin Postal Code: 101\nAdmin Country: IS\nAdmin Phone: +354.4212434\nAdmin Phone Ext: \nAdmin Fax: \nAdmin Fax Ext: \nAdmin Email: f736978976114b4ab0741e9ecf2a6a63.protect@withheldforprivacy.com\nRegistry Tech ID: \nTech Name: Redacted for Privacy\nTech Organization: Privacy service provided by Withheld for Privacy ehf\nTech Street: Kalkofnsvegur 2 \nTech City: Reykjavik\nTech State/Province: Capital Region\nTech Postal Code: 101\nTech Country: IS\nTech Phone: +354.4212434\nTech Phone Ext: \nTech Fax: \nTech Fax Ext: \nTech Email: f736978976114b4ab0741e9ecf2a6a63.protect@withheldforprivacy.com\nName Server: cheryl.ns.cloudflare.com\nName Server: nash.ns.cloudflare.com\nDNSSEC: unsigned\nURL of the ICANN WHOIS Data Problem Reporting System: http://wdprs.internic.net/\n>>> Last update of WHOIS database: 2024-08-07T16:56:13.14Z <<<\nFor more information on Whois status codes, please visit https://icann.org/epp",
    "registry_data": {
        "domain_name": "APIFREAKS.COM",
        "query_time": "2024-08-08 13:05:04",
        "whois_server": "whois.verisign-grs.com",
        "domain_registered": "yes",
        "domain_registrar": {
            "iana_id": "1068",
            "registrar_name": "NameCheap, Inc.",
            "whois_server": "whois.namecheap.com",
            "website_url": "http://www.namecheap.com",
            "email_address": "abuse@namecheap.com",
            "phone_number": "+1.6613102107"
        },
        "name_servers": [
            "cheryl.ns.cloudflare.com",
            "nash.ns.cloudflare.com"
        ],
        "domain_status": [
            "clientTransferProhibited"
        ],
        "whois_raw_registery": "\n   Domain Name: APIFREAKS.COM\n   Registry Domain ID: 2331617129_DOMAIN_COM-VRSN\n   Registrar WHOIS Server: whois.namecheap.com\n   Registrar URL: http://www.namecheap.com\n   Updated Date: 2024-04-30T11:03:18Z\n   Creation Date: 2018-11-11T11:49:12Z\n   Registry Expiry Date: 2024-11-11T11:49:12Z\n   Registrar: NameCheap, Inc.\n   Registrar IANA ID: 1068\n   Registrar Abuse Contact Email: abuse@namecheap.com\n   Registrar Abuse Contact Phone: +1.6613102107\n   Domain Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited\n   Name Server: CHERYL.NS.CLOUDFLARE.COM\n   Name Server: NASH.NS.CLOUDFLARE.COM\n   DNSSEC: unsigned\n   URL of the ICANN Whois Inaccuracy Complaint Form: https://www.icann.org/wicf/\n>>> Last update of whois database: 2024-08-08T13:04:53Z <<<\n\nFor more information on Whois status codes, please visit https://icann.org/epp\n\nNOTICE: The expiration date displayed in this record is the date the\nregistrar's sponsorship of the domain name registration in the registry is\ncurrently set to expire. This date does not necessarily reflect the expiration\ndate of the domain name registrant's agreement with the sponsoring\nregistrar.  Users may consult the sponsoring registrar's Whois database to\nview the registrar's reported date of expiration for this registration.\n\nTERMS OF USE: You are not authorized to access or query our Whois\ndatabase through the use of electronic processes that are high-volume and\nautomated except as reasonably necessary to register domain names or\nmodify existing registrations; the Data in VeriSign Global Registry\nServices' ("VeriSign") Whois database is provided by VeriSign for\ninformation purposes only, and to assist persons in obtaining information\nabout or related to a domain name registration record. VeriSign does not\nguarantee its accuracy. By submitting a Whois query, you agree to abide\nby the following terms of use: You agree that you may use this Data only\nfor lawful purposes and that under no circumstances will you use this Data\nto: (1) allow, enable, or otherwise support the transmission of mass\nunsolicited, commercial advertising or solicitations via e-mail, telephone,\nor facsimile; or (2) enable high volume, automated, electronic processes\nthat apply to VeriSign (or its computer systems). The compilation,\nrepackaging, dissemination or other use of this Data is exPressly\nprohibited without the prior written consent of VeriSign. You agree not to\nuse electronic processes that are automated and high-volume to access or\nquery the Whois database except as reasonably necessary to register\ndomain names or modify existing registrations. VeriSign reserves the right\nto restrict your access to the Whois database in its sole discretion to ensure\noperational stability.  VeriSign may restrict or terminate your access to the\nWhois database for failure to abide by these terms of use. VeriSign\nreserves the right to modify these terms at any time.\n\nThe Registry database contains ONLY .COM, .NET, .EDU domains and\nRegistrars."
    }
}