API docs

Making requests

GEThttps://whois-history-api.whoisxmlapi.com/api/v1?&apiKey=YOUR_API_KEY&domainName=google.com&mode=purchase
POSThttps://whois-history-api.whoisxmlapi.com/api/v1

It takes up to 2 minutes to activate your account after Sign Up.

POST request body sample

        {
    "apiKey": "YOUR_API_KEY",
    "domainName" : "google.com",
    "mode": "purchase"
}
    

Headers

X-Authentication-Token
You can use this header or apiKey parameter for API calls.
Get your personal API KEY on My products page.

Input parameters

apiKey
Get your personal API KEY on My products page.
domainName
Required. The domain for which historic WHOIS data is requested.
mode
Optional.

"preview" (default) – return only the number of domains. No credits deducted.

"purchase" – return the actual list of domains (limited to 10,000). 1 request costs 50 DRS credits.
responseFormat
Optional.

"json" (default) – response format will be JSON.

"xml" – response format will be XML.
sinceDate
Optional. Date in "YYYY-MM-DD" format.

If present, search through activities discovered since the given date. Sometimes there is a latency between the actual added/renewal/expired date and the date when our system detected this change. We recommend using this field in your monitoring tools for filtering daily changes.
createdDateFrom
Optional. Date in "YYYY-MM-DD" format.

If present, search through domains created after the given date.
createdDateTo
Optional. Date in "YYYY-MM-DD" format.

If present, search through domains created before the given date.
updatedDateFrom
Optional. Date in "YYYY-MM-DD" format.

If present, search through domains updated after the given date.
updatedDateTo
Optional. Date in "YYYY-MM-DD" format.

If present, search through domains updated before the given date.
expiredDateFrom
Optional. Date in "YYYY-MM-DD" format.

If present, search through domains expired after the given date.
expiredDateTo
Optional. Date in "YYYY-MM-DD" format.

If present, search through domains expired before the given date.

Sample output

JSON
XML
                            {
    "recordsCount": 7,
    "records" : [
        {
          "domainName": "google.com",
          "domainType": "added",
          "createdDateISO8601": "1997-09-15T00:00:00-07:00",
          "updatedDateISO8601": "2015-06-12T10:38:52-07:00",
          "expiresDateISO8601": "2020-09-13T21:00:00-07:00",
          "createdDateRaw": "1997-September-15",
          "updatedDateRaw": "12-June-2015",
          "expiresDateRaw": "2020 September-13",
          "audit": {
               "createdDate": "2018-06-17 11:23:51.000 UTC",
               "updatedDate": "2018-06-17 11:23:51.000 UTC"
          },
          "nameServers": [
               "NS1.GOOGLE.COM",
               "NS2.GOOGLE.COM",
               "NS3.GOOGLE.COM",
               "NS4.GOOGLE.COM"
           ],
          "whoisServer": "string",
          "registrarName": "string",
          "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)",
          ],
          "rawText": "string",
          "registrantContact": {
               "name": "string",
               "organization": "string",
               "street": "string",
               "city": "string",
               "state": "string",
               "postalCode": "string",
               "country": "string",
               "email": "string",
               "telephone": "string",
               "telephoneExt": "string",
               "fax": "string",
               "faxExt": "string",
               "rawText": "string"
         },
          "administrativeContact": {
               "name": "string",
               "organization": "string",
               "street": "string",
               "city": "string",
               "state": "string",
               "postalCode": "string",
               "country": "string",
               "email": "string",
               "telephone": "string",
               "telephoneExt": "string",
               "fax": "string",
               "faxExt": "string",
               "rawText": "string"
          },
         "technicalContact": {
               "name": "string",
               "organization": "string",
               "street": "string",
               "city": "string",
               "state": "string",
               "postalCode": "string",
               "country": "string",
               "email": "string",
               "telephone": "string",
               "telephoneExt": "string",
               "fax": "string",
               "faxExt": "string",
               "rawText": "string"
         },
         "billingContact": {
               "name": "string",
               "organization": "string",
               "street": "string",
               "city": "string",
               "state": "string",
               "postalCode": "string",
               "country": "string",
               "email": "string",
               "telephone": "string",
               "telephoneExt": "string",
               "fax": "string",
               "faxExt": "string",
               "rawText": "string"
          },
          "zoneContact": {
               "name": "string",
               "organization": "string",
               "street": "string",
               "city": "string",
               "state": "string",
               "postalCode": "string",
               "country": "string",
               "email": "string",
               "telephone": "string",
               "telephoneExt": "string",
               "fax": "string",
               "faxExt": "string",
               "rawText": "string"
          }
      },
      {
            ...
      },
      {
            ...
      }
    ]
}
                        
                            <xml>
    <records>
        <record>
            <domainName>google.com</domainName>
            <domainType>added</domainType>
            <createdDate>1997-09-15T00:00:00-07:00</createdDate>
            <updatedDate>2018-02-21T10:45:07-08:00</updatedDate>
            <expiresDate>2020-09-13T21:00:00-07:00</expiresDate>
            <audit>
                <createdDate>2018-03-30T11:48:39+00:00</createdDate>
                <updatedDate>2018-03-30T11:48:39+00:00</updatedDate>
            </audit>
            <nameServers>
                <nameServer>ns4.google.com</nameServer>
                <nameServer>ns2.google.com</nameServer>
                <nameServer>ns3.google.com</nameServer>
                <nameServer>ns1.google.com</nameServer>
            </nameServers>
            <whoisServer>whois.markmonitor.com</whoisServer>
            <registrarName>MarkMonitor, Inc.</registrarName>
            <status>
                <item>clientUpdateProhibited clientTransferProhibited clientDeleteProhibited serverUpdateProhibited serverTransferProhibited serverDeleteProhibited</item>
            </status>
            <rawText>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: 2018-02-21T10:45:07-0800
                Creation Date: 1997-09-15T00:00:00-0700
                Registrar Registration Expiration Date: 2020-09-13T21:00:00-0700
                Registrar: MarkMonitor, Inc.
                Registrar IANA ID: 292
                Registrar Abuse Contact Email: abusecomplaints@markmonitor.com
                Registrar Abuse Contact Phone: +1.2083895740
                Domain Status: clientUpdateProhibited (https://www.icann.org/epp#clientUpdateProhibited)
                Domain Status: clientTransferProhibited (https://www.icann.org/epp#clientTransferProhibited)
                Domain Status: clientDeleteProhibited (https://www.icann.org/epp#clientDeleteProhibited)
                Domain Status: serverUpdateProhibited (https://www.icann.org/epp#serverUpdateProhibited)
                Domain Status: serverTransferProhibited (https://www.icann.org/epp#serverTransferProhibited)
                Domain Status: serverDeleteProhibited (https://www.icann.org/epp#serverDeleteProhibited)
                Registry Registrant ID:
                Registrant Name: Domain Administrator
                Registrant Organization: Google LLC
                Registrant Street: 1600 Amphitheatre Parkway,
                Registrant City: Mountain View
                Registrant State/Province: CA
                Registrant Postal Code: 94043
                Registrant Country: US
                Registrant Phone: +1.6502530000
                Registrant Phone Ext:
                Registrant Fax: +1.6502530001
                Registrant Fax Ext:
                Registrant Email: dns-admin@google.com
                Registry Admin ID:
                Admin Name: Domain Administrator
                Admin Organization: Google LLC
                Admin Street: 1600 Amphitheatre Parkway,
                Admin City: Mountain View
                Admin State/Province: CA
                Admin Postal Code: 94043
                Admin Country: US
                Admin Phone: +1.6502530000
                Admin Phone Ext:
                Admin Fax: +1.6502530001
                Admin Fax Ext:
                Admin Email: dns-admin@google.com
                Registry Tech ID:
                Tech Name: Domain Administrator
                Tech Organization: Google LLC
                Tech Street: 1600 Amphitheatre Parkway,
                Tech City: Mountain View
                Tech State/Province: CA
                Tech Postal Code: 94043
                Tech Country: US
                Tech Phone: +1.6502530000
                Tech Phone Ext:
                Tech Fax: +1.6502530001
                Tech Fax Ext:
                Tech Email: dns-admin@google.com
                Name Server: ns4.google.com
                Name Server: ns2.google.com
                Name Server: ns3.google.com
                Name Server: ns1.google.com
                DNSSEC: unsigned
                URL of the ICANN WHOIS Data Problem Reporting System: http://wdprs.internic.net/
                >>> Last update of WHOIS database: 2018-03-30T04:30:06-0700 <<<

                The Data in MarkMonitor.com's WHOIS database is provided by MarkMonitor.com for
                information purposes, and to assist persons in obtaining information about or
                related to a domain name registration record.  MarkMonitor.com does not guarantee
                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 of mass unsolicited,
                commercial advertising or solicitations via e-mail (spam); or
                (2) enable high volume, automated, electronic processes that apply to
                MarkMonitor.com (or its systems).
                MarkMonitor.com reserves the right to modify these terms at any time.
                By submitting this query, you agree to abide by this policy.

                MarkMonitor is the Global Leader in Online Brand Protection.

                MarkMonitor Domain Management(TM)
                MarkMonitor Brand Protection(TM)
                MarkMonitor AntiPiracy(TM)
                MarkMonitor AntiFraud(TM)
                Professional and Managed Services

                Visit MarkMonitor at http://www.markmonitor.com
                Contact us at +1.8007459229
                In Europe, at +44.02032062220

                For more information on Whois status codes, please visit
                https://www.icann.org/resources/pages/epp-status-codes-2014-06-16-en
                --</rawText>
            <registrantContact>
                <name>Domain Administrator</name>
                <organization>Google LLC</organization>
                <street>1600 Amphitheatre Parkway,</street>
                <state>CA</state>
                <postalCode>94043</postalCode>
                <country>UNITED STATES</country>
                <email>dns-admin@google.com</email>
                <telephone>16502530000</telephone>
                <telephoneExt/>
                <fax>16502530001</fax>
                <faxExt/>
                <rawText>Registrant Name: Domain Administrator
                    Registrant Organization: Google LLC
                    Registrant Street: 1600 Amphitheatre Parkway,
                    Registrant City: Mountain View
                    Registrant State/Province: CA
                    Registrant Postal Code: 94043
                    Registrant Country: US
                    Registrant Phone: +1.6502530000
                    Registrant Fax: +1.6502530001
                    Registrant Email: dns-admin@google.com</rawText>
            </registrantContact>
            <administrativeContact>
                <name>Domain Administrator</name>
                <organization>Google LLC</organization>
                <street>1600 Amphitheatre Parkway,</street>
                <state>CA</state>
                <postalCode>94043</postalCode>
                <country>UNITED STATES</country>
                <email>dns-admin@google.com</email>
                <telephone>16502530000</telephone>
                <telephoneExt/>
                <fax>16502530001</fax>
                <faxExt/>
                <rawText>Admin Name: Domain Administrator
                    Admin Organization: Google LLC
                    Admin Street: 1600 Amphitheatre Parkway,
                    Admin City: Mountain View
                    Admin State/Province: CA
                    Admin Postal Code: 94043
                    Admin Country: US
                    Admin Phone: +1.6502530000
                    Admin Fax: +1.6502530001
                    Admin Email: dns-admin@google.com</rawText>
            </administrativeContact>
            <technicalContact>
                <name>Domain Administrator</name>
                <organization>Google LLC</organization>
                <street>1600 Amphitheatre Parkway,</street>
                <state>CA</state>
                <postalCode>94043</postalCode>
                <country>UNITED STATES</country>
                <email>dns-admin@google.com</email>
                <telephone>16502530000</telephone>
                <telephoneExt/>
                <fax>16502530001</fax>
                <faxExt/>
                <rawText>Tech Name: Domain Administrator
                    Tech Organization: Google LLC
                    Tech Street: 1600 Amphitheatre Parkway,
                    Tech City: Mountain View
                    Tech State/Province: CA
                    Tech Postal Code: 94043
                    Tech Country: US
                    Tech Phone: +1.6502530000
                    Tech Fax: +1.6502530001
                    Tech Email: dns-admin@google.com</rawText>
            </technicalContact>
            <billingContact>
                <name/>
                <organization/>
                <street/>
                <state/>
                <postalCode/>
                <country/>
                <email/>
                <telephone/>
                <telephoneExt/>
                <fax/>
                <faxExt/>
                <rawText/>
            </billingContact>
            <zoneContact>
                <name/>
                <organization/>
                <street/>
                <state/>
                <postalCode/>
                <country/>
                <email/>
                <telephone/>
                <telephoneExt/>
                <fax/>
                <faxExt/>
                <rawText/>
            </zoneContact>
        </record>
        <record>
            ...
        </record>
        <record>
            ...
        </record>
    </records>
    <recordsCount>14</recordsCount>
</xml>
                        
recordsCount
Number of historic records found for the target domain name
records
Array of whois records
records[k].domainName
Target domain name
records[k].domainType
Added or dropped
records[k].createdDateISO8601
The date the whois record for the domain was created initially, in ISO8601 format
records[k].updatedDateISO8601
The last date the whois record for the domain was updated, in ISO8601 format
records[k].expiresDateISO8601
The date the whois record for the domain is expired, in ISO8601 format
records[k].createdDateRaw
The date the whois record for the domain was created initially, in raw format
records[k].updatedDateRaw
The last date the whois record for the domain was updated, in raw format
records[k].expiresDateRaw
The date the whois record for the domain is expired, in raw format
records[k].audit
Contains audit dates for the target domain name
records[k].audit.createdDate
The date the domain was checked by our system initially
records[k].audit.updatedDate
The last the domains was checked by our system
records[k].nameServers
Array of name servers
records[k].whoisServer
Whois server
records[k].registrarName
Registrar name
records[k].rawText
The raw WHOIS record
records[k].cleanText
The raw WHOIS record but with comment strings removed
records[k].registrantContact
Contains registrant contact information
records[k].registrantContact.name
Registrant Name
records[k].registrantContact.organization
Registrant Organization
records[k].registrantContact.street
Registrant Street
records[k].registrantContact.city
Registrant City
records[k].registrantContact.state
Registrant State
records[k].registrantContact.postalCode
Registrant Postal Code
records[k].registrantContact.country
Registrant Country
records[k].registrantContact.email
Registrant Email
records[k].registrantContact.telephone
Registrant Telephone
records[k].registrantContact.telephoneExt
Registrant telephone extension
records[k].registrantContact.fax
Registrant Fax
records[k].registrantContact.faxExt
Registrant fax extension
records[k].registrantContact.rawText
Registrant contact information raw text
records[k].administrativeContact
Contains administrative contact information. The structure is the same as for "registrantContact" field.
records[k].technicalContact
Contains technical contact information. The structure is the same as for "registrantContact" field.
records[k].billingContact
Contains billing contact information. The structure is the same as for "registrantContact" field.
records[k].zoneContact
Contains zone contact information. The structure is the same as for "registrantContact" field.

Try WHOIS History API for free

Have questions?
support@whoisxmlapi.com
We will get back to you within a day.
WHOIS API, Inc.

California
USA

Contact us