Contact information

Contact type

An individual contact can be given a type setting when you associate it with a domain. This type setting is only configured for the associated domain.

In IRS a domain name has four types of contact associated with it: * Registrant (required) * Admin (required) * Technical (required) * Billing (optional)

Only one of each contact type is allowed.

The billing contact is optional and it can be used to indicate individuals or non-individuals that are authorized by the Registrant to administer financial information for a registered domain. This contact is not published in the WHOIS.

The same individual contact can be assigned as the registrant, administrative, technical and billing contact for one or more domain names.

Postal address information (postalInfo element)

EPP provides the <contact:postalInfo> elements that contain postal address information.

The IRS registry-supported type is “loc” indicating that the address is in a localized form. Eg:

. code-block:: xml

<contact:postalInfo type=”loc”>


This is an optional field in IRS. The organisation that the contact represents. If entered, the organisation name must be from two (2) to two-hundred and fifty-five (255) characters in length. All characters are valid.

Phone number

In IRS the phone number is an optional field.

The length of the phone number is based on the specified country code. For example, for country code +1 the phone number must be 10 digits long.

If required, you can add an extension number in the extension field. The extension number must be from zero (0) to ten (10) digits long.

Authorisation code

An authorisation code is required to be provided as part of the contact create command. This is part of the EPP standard and authorisation information is a required field.

Contacts are not transferred between registrars so the authorisation information will not be used.

Creating a contact

Contacts can be created using the IRS portal or via the EPP API.

A contact can be for an individual or a non-individual. The following guidance should be followed when creating a registrant contact:

  • For an individual, “Name” is used for the name of the domain name holder/registrant

  • For a non-individual, “Name” is used for the company or organisation name of the domain name holder. The org field can be used to provide additional information about the company/organisation if required.

Updating a contact

Contacts can be updated using the IRS portal or via the EPP API.

Deleting a contact

The IRS housekeeper deletes orphaned contact records after a defined period of time.


While a contact is associated to a domain it has a status of linked.

When the contact record becomes orphaned, the “pending_delete_effective” period begins (set to 60 days). At the end of this period the status changes to pendingDelete.

As soon as the contact is in a state pendingDelete the “pending_delete_expiry” continues. Note the pending delete expiry period (90 days) is the total sum of the orphaned and pendingDelete states. At the end of this period the housekeeper deletes the contact.

To restore the contact from the pendingDelete state, link (re-associated) it with a domain, the status will return to linked and the counters are reset.