Secure Login

Read Me: Bulk Whois Report

The publication of bulk Whois data is provided subject to an approved request under ARIN's Bulk Whois Acceptable Use Policy.

ARIN's Whois data is for Internet operational or technical research purposes pertaining to Internet operations only. It may not be used for advertising, direct marketing, marketing research, or similar purposes. Use of ARIN's Whois data for these activities is explicitly forbidden. ARIN requests to be notified of any such activities or suspicions thereof.

Redistributing bulk ARIN Whois data is explicitly forbidden. Distribution of derivative data is only permitted with the express written permission of ARIN and under the same terms as this AUP. It is permissible to publish the data on an individual query or small number of queries at a time basis, as long as reasonable precautions are taken to prevent automated querying by database harvesters.

By retrieving this data, you agree to the acceptable use policy for ARIN's Whois data and confirm the accuracy of the information provided in your request.

Report Summary

This report contains the POC records, organization records, and AS, IPv4, and IPv6 registrations that are displayed in ARIN's public Whois.

It is possible to selectively download only parts of the Bulk Whois in either zip, txt, or xml.

Through ARIN Online, authorized users can download a file of all Whois object types or to select a file containing a particular Whois object type.

Specifying public/secure/downloads/bulkwhois/XXX+YYY.zip where XXX and YYY can be any combination of "asns", "pocs", "orgs", or "nets" will yield only that information in the zip file. The combination can be any of these or all of these (e.g. nets+asns+orgs.zip).

Specifying an extension of .txt yields the same result, but only the text rendering.

Specifying an extension of .xml yields the same result, but only the xml rendering.

The file names returned are always arin_db.txt and arin_db.xml regardless of the data objects specified.

Contents of ZIP File

arin_db.xml

the report in XML format

arin_db.txt

the legacy bulk Whois format

legacy.xsl

the XSLT template used to generate the legacy format from the XML format

schemas

directory of RelaxNG schema files that define the xml document above

README.txt

this file

Description of Elements

This section provides a semantic description of many of the XML and legacy elements in the report, depending on the data object types specified.

General XML Elements

ref

the URL for this record in the RESTful Whois service

handle

unique id for this record

registrationDate

date the resource/poc/org was created in ARIN's database

updateDate

date the record was last changed

ASN XML Elements

asn

element containing info about a single Autonomous System Number registration

name

the Autonomous System name

startAsNumber

the first AS number in the registration

endAsNumber

the last AS number in the registration range. If the resource registration only represents a single AS number, then the endAsNumber is the same as the startAsNumber.

orgHandle

the org handle of the org to which this resource has been issued. This field will match the 'handle' field of an 'org' entity.

pocLinks

a list of POCs that are directly associated with this ASN resource. Each POC link lists the POC's handle, function code and a short description of the function

NET XML Elements

net

element containing info about a single Network registration

name

the network name

startAddress

when the parent XML element is a netBlock this represents the starting IP address of that block. When the parent XML element is a net, this represents the lowest startAddress of all listed netBlocks.

endAddress

when the parent XML element is a netBlock this represents the ending IP address of that block. When the parent XML element is a net, this represents the highest endAddress of all listed netBlocks.

orgHandle

the org handle of the org to which this resource has been issued. This field will match the 'handle' field of an 'org' entity.

pocLinks

a list of POCs that are directly associated with this network resource. Each POC link lists the POC's handle, function code and a short description of the function

where XXX and YYY can be any combination of "asns", "pocs", "orgs", or "nets", which
will yield only that information in the file. The combination can be any of these
or all of these (e.g. nets+asns+orgs.zip). The file type can be zip, txt, or xml.

There are a variety of ways to automate the retrieval of this report. For example, on a Linux system, where your API key is API-1111-2222-3333-4444, you can use the following 'curl' command to download the report file: