Read Me: Report of Resources with No Valid POCs

Note: The schema used in the report of number resources without valid POCs changed with the 16 September 2017 update of ARIN Online. This schema is included in the .zip file of the report that is downloaded. Please be sure that your automated scripts parse this new XML format.

The list of number resources without valid POCs 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 this 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 a list of Networks and ASNs that meet the following criteria:

  • There are no POCs associated with the resource either directly (a resource POC) or indirectly (a POC associated with the resource’s Org)
  • ALL POCs associated with the resource are invalid. A POC handle is marked invalid by ARIN staff when the POC has not been modified in more than one year and the POC fails to respond to ARIN’s requests to validate the POC information.

Contents of ZIP File

the report in XML format
the report in text format
the XSLT template used to generate the text format from the XML format
directory of RelaxNG schema files that define the xml document above
this file

Description of Elements

This section provides a semantic description of many of the XML elements in the report.

General XML Elements

either an ASN handle, Net Handle, or Org handle depending on the type of the immediate parent XML element
orgHandle & orgName
element containing info about an organization. Always nested within ASN and net XML elements. Identifies the organization to which the net/ASN has been allocated.
when nested within an org XML element, this represents the organization name.

ASN XML Elements

element containing info about a single Autonomous System Number resource
the first ASN in the registration
the last ASN in the registration range. If the resource registration only represents a single ASN, then the endAsNumber is the same as the startAsNumber.

Invalid POC XML Elements

These elements are nested within an invalidPoc element.

The handle of the invalid POC
The name of the invalid POC
The date that the POC was last updated

NET XML Elements

element containing info about a single Network resource
the lowest IP (v4 or v6) address of a range of consecutive IP address blocks assigned to a single net handle
the highest IP (v4 or v6) address of a range of consecutive IP address blocks assigned to a single net handle

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:

Each major element of the schema is broken out into its own .rnc file. The top level file is nvpr.rnc. All other schema fragments will be referenced from nvpr.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/nvpr.rnc no-valid-poc-resource-report.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. The URL must look like:

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 \> arin\

You can manage your API keys from the Settings page when logged into your ARIN Online account.

  • Read Me: Report of Resources with No Valid POCs

Registration Services Help Desk
7:00 AM to 7:00 PM ET
Phone: +1.703.227.0660
Fax: +1.703.997.8844

Tips for Calling the Help Desk