Reassignment and Reallocation Templates

ARIN customers can report reallocation/reassignment data by sending a completed email form, or template, to hostmaster@arin.net, or by using the Reg-RWS Application Programming Interface (API).

In 2020, as a result of policy changes ARIN 2017-12 and ARIN 2018-5, developed by the ARIN community, ARIN no longer allows an organization to create Points of Contact (POCs) or Organization IDs (Org IDs) for another organization. A recipient organization must create an Org ID and POC with ARIN before receiving a reassignment or reallocation.

To support this change, email templates have been updated to Version 5.3. Submitted templates that do not meet the new policy guidelines will fail. Policy also requires that ARIN notify, via email, the requester and all POCs associated with the receiving organization, whether the request was successful or not, and request validation of any invalid POC objects associated with the receiving organization.

Version 5.3 Email Templates

  • IPv4 Reallocate Template: Use this to subdelegate IPv4 addresses to a downstream organization that needs to maintain its own reverse nameservers and/or separate POC information, and make reassignments of IP addresses to its own customers.
  • IPv6 Reallocate Template: Use this to subdelegate IPv6 addresses to a downstream organization that needs to maintain its own reverse nameservers and/or separate POC information, and make reassignments of IP addresses to its own customers.
  • IPv4 Reassign Template: Use this to subdelegate IPv4 addresses to a downstream organization that needs to maintain its own reverse nameservers and/or separate POC information but does not need to further subdelegate the IP addresses.
  • IPv6 Reassign Template: Use this to subdelegate IPv6 addresses to a downstream organization that needs to maintain its own reverse nameservers and/or separate POC information but does not need to further subdelegate the IP addresses.

Email Template Processing Status Responses

Downstream Org ID is Missing From Template

This message is sent via email to the template sender. It means that the Org ID of your downstream customer or organization is missing from the email template that you submitted. If necessary, please contact the organization to obtain their Org ID, and then resubmit the template with this information.

Hello,

ARIN was unable to process your request:

Downstream Org ID: Value required.

Many errors can be prevented by ensuring your e-mail client sends mail as “Plain Text”, not as “HTML” or “Rich Text”. ARIN only accepts templates in plain text format.

Please do not hesitate to contact us if you have any additional questions, comments, or concerns.

Web: Ask ARIN while logged in to your ARIN Online account
E-mail: hostmaster@arin.net
Phone: +1.703.227.0660

Regards,

Registration Services
American Registry for Internet Numbers

Downstream Org ID in Template Does Not Exist in Whois

This message is sent via email to the template sender. It means that the Org ID of your downstream customer or organization that you provided in your email template submission does not exist in ARIN’s Whois. Please contact the organization to have them create their Org ID or supply you with the correct Org ID, and then resubmit the template with this information.

Hello,

ARIN was unable to process your request:

Downstream Org ID: The referenced object does not exist.

Many errors can be prevented by ensuring your e-mail client sends mail as “Plain Text”, not as “HTML” or “Rich Text”. ARIN only accepts templates in plain text format.

Please do not hesitate to contact us if you have any additional questions, comments, or concerns.

Web: Ask ARIN while logged in to your ARIN Online account
E-mail: hostmaster@arin.net
Phone: +1.703.227.0660

Regards,

Registration Services
American Registry for Internet Numbers

Downstream Org in Template Has No Validated POC

This message is sent via email to the template sender. It means that the downstream customer or organization you provided in your email template submission does not have a validated POC associated with their Org ID. Please contact the organization and ask them to validate one or more of the POCs that are associated with their Org ID. After they do this, resubmit the template.

Hello,

ARIN was unable to process your request:

Downstream Org ID: The organization receiving the network must have at least one validated POC.

Many errors can be prevented by ensuring your e-mail client sends mail as “Plain Text”, not as “HTML” or “Rich Text”. ARIN only accepts templates in plain text format.

Please do not hesitate to contact us if you have any additional questions, comments, or concerns.

Web: Ask ARIN while logged in to your ARIN Online account E-mail: hostmaster@arin.net Phone: +1.703.227.0660

Regards,

Registration Services
American Registry for Internet Numbers

Downstream Org or POC Cannot be Created Using Template

This message is sent via email to the template sender. It is sent when you have entered information to create a new Org or POC in your email template submission. Per policy adopted in 2019 and implemented in 2020, you can no longer create new Orgs or POCs for downstream organizations when submitting reassignments or reallocations. The downstream organization must create their own Org ID and POC.

Please contact the downstream organization to get their Org ID and POC. After they have created them, resubmit the template with this information.

Hello,

ARIN was unable to process your request:

Downstream Org ID: You cannot create Org or POC records for downstream customers. Please supply Org ID from Whois.

Many errors can be prevented by ensuring your e-mail client sends mail as “Plain Text”, not as “HTML” or “Rich Text”. ARIN only accepts templates in plain text format.

Please do not hesitate to contact us if you have any additional questions, comments, or concerns.

Web: Ask ARIN while logged in to your ARIN Online account E-mail: hostmaster@arin.net Phone: +1.703.227.0660

Regards,

Registration Services
American Registry for Internet Numbers

Email Template Processing Was Successful

This message is sent via email to the template sender and verifies that the email template was processed successfully.

Hello,

ARIN has completed the processing of your template as requested.

The POC Handle for your POC is <POC-HANDLE>. The record will be visible in ARIN’s Whois shortly and can be accessed via the link below:

http://whois.arin.net/rest/poc/<POC-HANDLE>

The Organization Handle for your ORG is <ORG-HANDLE>. The record will be visible in ARIN’s Whois shortly and can be accessed via the link below:

http://whois.arin.net/rest/org/<ORG-HANDLE>

The Net Handle for the reassigned network is <NET-HANDLE>. The record will be visible in ARIN’s Whois shortly and can be accessed via the link below:

http://whois.arin.net/rest/net/<NET-HANDLE>

Please do not hesitate to contact us if you have any additional questions, comments, or concerns.

Web: Ask ARIN while logged in to your ARIN Online account
E-mail: hostmaster@arin.net
Phone: +1.703.227.0660

Regards,

Registration Services
American Registry for Internet Numbers

Reg-RWS API Reassignment/Reallocation Status Messages

Downstream Org ID Does Not Exist in Whois

This message is sent to the email address of the user whose API Key is included in the request. (The API key is specified in the REST call that was sent to ARIN’s Reg-RWS system.)

Hello,

This is courtesy message to notify you that the reassignment of <IP-ADDRESSES> to an organization with Org ID <ORG-HANDLE> was not successful. The reassignment could not be processed because the downstream Organization Identifier (Org ID) provided does not exist in ARIN’s Whois database. Please review ARIN’s Whois to verify the correct downstream Org ID and resubmit your reassignment request.

Please do not hesitate to contact us if you have any additional questions, comments, or concerns. ARIN’s Registration Services Help Desk can be reached Monday through Friday between 7:00 a.m. and 7:00 p.m. ET via phone at +1.703.227.0660 or by submitting an Ask ARIN ticket from within your ARIN Online account.

Regards,

Registration Services Department
American Registry for Internet Numbers

Downstream Org Has No Validated POC

This message is sent to all POCs for the downstream Org.

Hello,

The reassignment of <IP-ADDRESSES> to <ORG-NAME> (<ORG-HANDLE>) was not successful. The reassignment could not be processed because the downstream Organization Identifier (Org ID) does not have any validated Points of Contact (POCs).

To receive the reassignment, your Organization must have at least one validated POC. ARIN policy requires all POCs to be validated annually. To validate your POC, log in to your ARIN Online account and select Point of Contact Records from the navigation menu. POCs that require validation are noted. Once you’ve validated your POC, please contact your upstream provider, <UPSTREAM-ORG-NAME> (https://whois.arin.net/rest/org/<UPSTREAM-ORG-HANDLE>), so they can retry the reassignment.

Please do not hesitate to contact us if you have any additional questions, comments, or concerns. ARIN’s Registration Services Help Desk can be reached Monday through Friday between 7:00 a.m. and 7:00 p.m. ET via phone at +1.703.227.0660 or by submitting an Ask ARIN ticket from within your ARIN Online account.

Regards,

Registration Services Department
American Registry for Internet Numbers

This email is sent to the email address of the user whose API Key is included in the request. (The API key is specified in the REST call that was sent to ARIN’s Reg-RWS system.)

Hello,

The reassignment of <IP-ADDRESSES> to <ORG-NAME> (<ORG-HANDLE>) was not successful. The reassignment could not be processed because the downstream Organization Identifier (Org ID) does not have any validated Points of Contact (POCs).

To receive the reassignment, the downstream Organization must have at least one validated POC. Ask your downstream customer to validate their ARIN POCs. After they do so, you can retry the reassignment.

Please do not hesitate to contact us if you have any additional questions, comments, or concerns. ARIN’s Registration Services Help Desk can be reached Monday through Friday between 7:00 a.m. and 7:00 p.m. ET via phone at +1.703.227.0660 or by submitting an Ask ARIN ticket from within your ARIN Online account.

Regards,

Registration Services Department American Registry for Internet Numbers

Reg-RWS API Reallocation/Reassignment Was Successful

This message is sent to all POCs for the downstream Org.

Hello,

The reassignment of <IP-ADDRESSES> to <ORG-NAME> (<ORG-HANDLE>) was successful. The record will be published in ARIN’s Whois. Visit https://whois.arin.net/rest/net/<NET-HANDLE> to access the reassignment.

If you have any questions related to this reassignment, please contact <UPSTREAM-ORG-NAME> (https://whois.arin.net/rest/org/<UPSTREAM-ORG-HANDLE>).

Please take a moment to verify your Point of Contact (POC) records. ARIN policy requires all POCs to be validated annually. To verify and validate, log in to your ARIN Online account and select Point of Contact Records (POCs) from your Dashboard. POCs that require validation are noted.

Please do not hesitate to contact us if you have any additional questions, comments, or concerns. ARIN’s Registration Services Help Desk can be reached Monday through Friday between 7:00 a.m. and 7:00 p.m. ET via phone at +1.703.227.0660 or by submitting an Ask ARIN ticket from within your ARIN Online account.

Regards,

Registration Services Department
American Registry for Internet Numbers

This message is sent to the email address of the user whose API Key is included in the request. (The API key is specified in the REST call that was sent to ARIN’s Reg-RWS system.) It means that the reassignment or reallocation was successfully processed.

Hello,

The reassignment of <IP-ADDRESSES> to <ORG-NAME> (<ORG-HANDLE>) was successful. The record will be published in ARIN’s Whois. Visit https://whois.arin.net/rest/net/<NET-HANDLE> to access the reassignment.

Please take a moment to verify your Point of Contact (POC) records. ARIN policy requires all POCs to be validated annually. To verify and validate, log in to your ARIN Online account and select Point of Contact Records (POCs) from your Dashboard. POCs that require validation are noted.

Please do not hesitate to contact us if you have any additional questions, comments, or concerns. ARIN’s Registration Services Help Desk can be reached Monday through Friday between 7:00 a.m. and 7:00 p.m. ET via phone at +1.703.227.0660 or by submitting an Ask ARIN ticket from within your ARIN Online account.

Regards,

Registration Services Department
American Registry for Internet Numbers

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