WHOIS Lookup

Look up any domain WHOIS and registrar data that is publicly available

Authentication

ApiStacks uses API keys to authenticate requests. You can view and manage your API keys in the Dashboard.

Your API keys carry many privileges. To keep them from being abused, please do not share the keys on client-side code or Github etc. Keep them very secure.

All requests made to the API must contain the parameter api_key in each of your requests. API requests without authentication will fail.

All API requests must also be made over secure HTTPS. Requests made over plain HTTP may fail.

Endpoint

GET /getwhois

api_key (required)

In your Request URL, provide the API Key found within your Dashboard

url (required)

The domain name that you want to retrieve registrar information from, e.g. http://abc.com

Premium Parameters

These parameters require a paid subscription to modify

response_type (optional)

Set to “JSON”, “XML”, or “YAML” depending what type of response you want from the API.

Want to test this API and get live results?

Sample Request

curl --request GET \
--url 'https://api.apistacks.com/v1/getwhois?api_key={APIKEY}&url={url}' \

Sample Response

{
    "status": "ok",
    "timestamp": 1651635764033,
    "data": {
        "whois.verisign-grs.com": {
            "Domain Status": [
                "clientDeleteProhibited https://icann.org/epp#clientDeleteProhibited",
                "clientTransferProhibited https://icann.org/epp#clientTransferProhibited",
                "clientUpdateProhibited https://icann.org/epp#clientUpdateProhibited",
                "serverDeleteProhibited https://icann.org/epp#serverDeleteProhibited",
                "serverTransferProhibited https://icann.org/epp#serverTransferProhibited",
                "serverUpdateProhibited https://icann.org/epp#serverUpdateProhibited"
            ],
            "Name Server": [
                "NS1.GOOGLE.COM",
                "NS2.GOOGLE.COM",
                "NS3.GOOGLE.COM",
                "NS4.GOOGLE.COM"
            ],
            "Domain Name": "GOOGLE.COM",
            "Registry Domain ID": "2138514_DOMAIN_COM-VRSN",
            "Registrar WHOIS Server": "whois.markmonitor.com",
            "Registrar URL": "http://www.markmonitor.com",
            "Updated Date": "2019-09-09T15:39:04Z",
            "Created Date": "1997-09-15T04:00:00Z",
            "Expiry Date": "2028-09-14T04:00:00Z",
            "Registrar": "MarkMonitor Inc.",
            "Registrar IANA ID": "292",
            "Registrar Abuse Contact Email": "[email protected]",
            "Registrar Abuse Contact Phone": "+1.2086851750",
            "DNSSEC": "unsigned",
            "URL of the ICANN Whois Inaccuracy Complaint Form": "https://www.icann.org/wicf/",
            ">>> Last update of whois database": "2022-05-04T03:42:32Z <<<",
            "text": [
                "For more information on Whois status codes, please visit https://icann.org/epp",
                "",
                "NOTICE: The expiration date displayed in this record is the date the",
                "registrar's sponsorship of the domain name registration in the registry is",
                "currently set to expire. This date does not necessarily reflect the expiration",
                "date of the domain name registrant's agreement with the sponsoring",
                "registrar.  Users may consult the sponsoring registrar's Whois database to",
                "view the registrar's reported date of expiration for this registration.",
                "",
                "TERMS OF USE: You are not authorized to access or query our Whois",
                "database through the use of electronic processes that are high-volume and",
                "automated except as reasonably necessary to register domain names or",
                "modify existing registrations; the Data in VeriSign Global Registry",
                "Services' (\"VeriSign\") Whois database is provided by VeriSign for",
                "information purposes only, and to assist persons in obtaining information",
                "about or related to a domain name registration record. VeriSign does not",
                "guarantee its accuracy. By submitting a Whois query, you agree to abide",
                "by the following terms of use: You agree that you may use this Data only",
                "for lawful purposes and that under no circumstances will you use this Data",
                "to: (1) allow, enable, or otherwise support the transmission of mass",
                "unsolicited, commercial advertising or solicitations via e-mail, telephone,",
                "or facsimile; or (2) enable high volume, automated, electronic processes",
                "that apply to VeriSign (or its computer systems). The compilation,",
                "repackaging, dissemination or other use of this Data is expressly",
                "prohibited without the prior written consent of VeriSign. You agree not to",
                "use electronic processes that are automated and high-volume to access or",
                "query the Whois database except as reasonably necessary to register",
                "domain names or modify existing registrations. VeriSign reserves the right",
                "to restrict your access to the Whois database in its sole discretion to ensure",
                "operational stability.  VeriSign may restrict or terminate your access to the",
                "Whois database for failure to abide by these terms of use. VeriSign",
                "reserves the right to modify these terms at any time.",
                "",
                "The Registry database contains ONLY .COM, .NET, .EDU domains and",
                "Registrars."
            ]
        },
        "whois.markmonitor.com": {
            "Domain Status": [
                "clientUpdateProhibited (https://www.icann.org/epp#clientUpdateProhibited)",
                "clientTransferProhibited (https://www.icann.org/epp#clientTransferProhibited)",
                "clientDeleteProhibited (https://www.icann.org/epp#clientDeleteProhibited)",
                "serverUpdateProhibited (https://www.icann.org/epp#serverUpdateProhibited)",
                "serverTransferProhibited (https://www.icann.org/epp#serverTransferProhibited)",
                "serverDeleteProhibited (https://www.icann.org/epp#serverDeleteProhibited)"
            ],
            "Name Server": [
                "ns1.google.com",
                "ns3.google.com",
                "ns4.google.com",
                "ns2.google.com"
            ],
            "Domain Name": "google.com",
            "Registry Domain ID": "2138514_DOMAIN_COM-VRSN",
            "Registrar WHOIS Server": "whois.markmonitor.com",
            "Registrar URL": "http://www.markmonitor.com",
            "Updated Date": "2019-09-09T15:39:04+0000",
            "Created Date": "1997-09-15T07:00:00+0000",
            "Expiry Date": "2028-09-13T07:00:00+0000",
            "Registrar": "MarkMonitor, Inc.",
            "Registrar IANA ID": "292",
            "Registrar Abuse Contact Email": "[email protected]",
            "Registrar Abuse Contact Phone": "+1.2083895770",
            "Registrant Organization": "Google LLC",
            "Registrant State/Province": "CA",
            "Registrant Country": "US",
            "Registrant Email": "Select Request Email Form at https://domains.markmonitor.com/whois/google.com",
            "Admin Organization": "Google LLC",
            "Admin State/Province": "CA",
            "Admin Country": "US",
            "Admin Email": "Select Request Email Form at https://domains.markmonitor.com/whois/google.com",
            "Tech Organization": "Google LLC",
            "Tech State/Province": "CA",
            "Tech Country": "US",
            "Tech Email": "Select Request Email Form at https://domains.markmonitor.com/whois/google.com",
            "DNSSEC": "unsigned",
            "URL of the ICANN WHOIS Data Problem Reporting System": "http://wdprs.internic.net/",
            ">>> Last update of WHOIS database": "2022-05-04T03:41:47+0000 <<<",
            "text": [
                "For more information on WHOIS status codes, please visit:",
                "https://www.icann.org/resources/pages/epp-status-codes",
                "",
                "If you wish to contact this domain’s Registrant, Administrative, or Technical",
                "contact, and such email address is not visible above, you may do so via our web",
                "form, pursuant to ICANN’s Temporary Specification. To verify that you are not a",
                "robot, please enter your email address to receive a link to a page that",
                "facilitates email communication with the relevant contact(s).",
                "",
                "Web-based WHOIS:",
                "https://domains.markmonitor.com/whois",
                "",
                "If you have a legitimate interest in viewing the non-public WHOIS details, send",
                "your request and the reasons for your request to [email protected]",
                "and specify the domain name in the subject line. We will review that request and",
                "may ask for supporting documentation and explanation.",
                "",
                "The data in MarkMonitor’s WHOIS database is provided for information purposes,",
                "and to assist persons in obtaining information about or related to a domain",
                "name’s registration record. While MarkMonitor believes the data to be accurate,",
                "the data is provided \"as is\" with no guarantee or warranties regarding its",
                "accuracy.",
                "",
                "By submitting a WHOIS query, you agree that you will use this data only for",
                "lawful purposes and that, under no circumstances will you use this data to:",
                "(1) allow, enable, or otherwise support the transmission by email, telephone,",
                "or facsimile of mass, unsolicited, commercial advertising, or spam; or",
                "(2) enable high volume, automated, or electronic processes that send queries,",
                "data, or email to MarkMonitor (or its systems) or the domain name contacts (or",
                "its systems).",
                "",
                "MarkMonitor reserves the right to modify these terms at any time.",
                "",
                "By submitting this query, you agree to abide by this policy.",
                "",
                "MarkMonitor Domain Management(TM)",
                "Protecting companies and consumers in a digital world.",
                "",
                "Visit MarkMonitor at https://www.markmonitor.com",
                "Contact us at +1.8007459229",
                "In Europe, at +44.02032062220",
                "--"
            ]
        }
    }
}

Rate Limiting

Each subscription has its own rate limit. Your limit is based on your subscription plan (free or paid). If you exceed your limits, don’t worry. You can always upgrade or downgrade at any time.

When you reach a rate limit (both daily and monthly), the service will stop responding and return an HTTP 429 response status code. The error will contain the following JSON string body text.

{
    "status": "fail",
    "data": "",
    "reason": "Usage limit reached. Please review/upgrade your account"
}

A reminder email will be sent to you when your API usage reaches 80% and 90% so that you can take immediate actions such as upgrading your plan in order to prevent your application using the API from being interrupted.

Error Codes

ApiStacks uses standard HTTP response codes to indicate the success or failure of an API request.

If the response code is not 200 Ok, it means the operation has failed. You can check the response for a field called ‘reason‘ that briefly explains what the error may be.

Status CodeReason
400The request was not complete or malformed. Parameters may be missing
401API key was not provided or was not valid
403Usage limit was likely reached or the app was not enabled in the dashboard
404API Endpoint does not exist
405Method is not allowed (Only use GET)
500An error occurred on our end