Your IP address could not be determined at this time.

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.

  1. 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.
  2. 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).
    1. Specifying an extension of .txt yields the same result, but only the text rendering.
    2. Specifying an extension of .xml yields the same result, but only the xml rendering.
  3. 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
netBlocks
a list of contiguous net blocks assigned to this net
cidrLength
the CIDR prefix for a net block
type
the type of net block. One of the following:
A (Reallocation)
AF (Allocated to AFRINIC)
AP (Allocated to APNIC)
AR (Allocated to ARIN)
AV (Early registrations maintained by ARIN)
DA (Direct Allocation)
DS (Direct Assignment)
FX (Transferred to AFRINIC)
IR (IANA Reserved)
IU (IANA Special Use)
LN (Allocated to LACNIC)
LX (Transferred to LACNIC)
PV (Early registrations maintained by APNIC)
PX (Early registrations transferred to APNIC)
RN (Allocated to RIPE NCC)
RV (Early registrations maintained by RIPE NCC)
RX (Early registrations transferred to RIPE NCC)
S (Reassignment)
parentNetHandle
the net handle for the parent net
version
IP version, either 4 or 6
POC XML Elements
poc
element containing info about a single Point Of Contact
iso3166-1
the ISO standard codes defining the country where this POC is registered
iso3166-2
the ISO standard codes defining the state/province where this POC is registered
companyName
the company/orgainization this POC is representing
isRoleAccount
if 'N', this POC represents an individual, if 'Y', this POC represents a role, or group
ORG XML Elements
org
element containing info about a single organization
iso3166-1
the ISO standard codes defining the country where this organization is registered
iso3166-2
the ISO standard codes defining the state/province where this organization is registered
customer
'Y' if the organization record does not have its own contact information or reverse DNS delegation (aka: simple reassignment), otherwise, 'N'
pocLinks
a list of POCs that are directly associated with this organization. Each POC link lists the POC's handle, function code and a short description of the function

Schema Validation

This section contains additional information for those who wish to review the schemas or use them to validate the xml.

The provided schemas are written in Relax NG Compact Syntax. Detailed info about Relax NG syntax can be found here: http://www.relaxng.org/compact-tutorial-20030326.html

Each major element of the schema is broken out into its own .rnc file. The top level file is bwi.rnc. All other schema fragments will be referenced from bwi.rnc.

Validation and parsing with RelaxNG Compact Schema can be done in Java using Jing

Jing provides a jar file and API to invoke Relax NG validation for a given schema and xml document. You can also run it from the command line:

java -jar jing.jar -c schema/bwi.rnc arin_db.xml

Downloading Using an API Key

The report can be downloaded directly without logging into ARIN Online using a RESTful HTTP request containing your API key. For the file containing all Whois object types, the URL must look like:

https://www.arin.net/public/secure/downloads/bulkwhois?apikey=YOUR-API-KEY

You can also selectively download only parts of the Bulk Whois through a RESTful HTTP request. The URL must look like:

https://www.arin.net/public/secure/downloads/bulkwhois/XXX+YYY.zip?apikey=YOUR-API-KEY

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:

curl https://www.arin.net/public/secure/downloads/bulkwhois?apikey=API-1111-2222-3333-4444 > arin_bulkwhois.zip

You can manage your API keys on the Web Account page when logged into your ARIN Online account.