Glossary

Objects

The IRS EPP protocol uses three object types:

  1. Domain objects contain information about domain names,

  2. Contact objects contain information about the contacts that are associated with domain names, like the registrant, the admin contact, the technical contact and the new optional billing contact; See the Contacts section for more info, and

  3. Host objects contain nameserver information.

Object Status Values

Client Status values are assigned by the Registrar while Server Status values are either automatically assigned by IRS or manually assigned by a system-level user. Support Status values are manually assigned by a system-level user.

Client Status Values

Status

Description

clientDeleteProhibited

This status prevents the object from being removed from the Registry and can be assigned to Domains, Contacts, or Hosts.

clientHold

Assigned by the Registrar, this status stops the Registry from activating a Domain in DNS which means that the domain name will not resolve. This status cannot be assigned to Contacts or Hosts.

clientRenewProhibited

This status prevents Domains from being renewed and cannot be assigned to either Contacts or Hosts. Note: A domain with the clientRenewProhibited status is still subject to automatic renewals as this status will only prevent manual or explicit renewals.

clientUpdateProhibited

This status prevents properties of the object in the Registry from being modified and can be assigned to Domains, Contacts, or Hosts.

clientTransferProhibited

.nz Registrars are not permitted to set clientTransferProhibited status flag.

Server Status Values

Status

Description

Inactive

This status is assigned to a Domain that is not associated with any Hosts which means that the domain name is not activated in DNS and will not resolve. This status cannot be assigned to Contacts or Hosts.

Ok

This is the normal status value for an object that has no pending operations or restrictions and is automatically assigned or removed by IRS as other status values are assigned or removed.

serverDeleteProhibited

This status prevents the object from being removed from the Registry and can be assigned to Domains, Contacts, or Hosts.

serverHold

Automatically assigned by IRS or manually assigned by a system-level user, this status stops the Registry from activating a Domain in DNS which means that the domain name will not resolve. This status cannot be assigned to Contacts or Hosts.

serverRenewProhibited

This status prevents Domains from being renewed and cannot be assigned to either Contacts or Hosts. Note: A domain with the serverRenewProhibited status is prevented from being subject to automatic renewal.

serverTransferProhibited

This status prevents Domains from being transferred and cannot be assigned to either Contacts or Hosts.

serverUpdateProhibited

This status prevents the object in the Registry from being modified and can be assigned to Domains, Contacts, or Hosts.

Support Status Values

Status

Description

serverDeleteProhibited

This status prevents the object from being removed from the Registry and can be assigned to Domains, Contacts, or Hosts.

serverHold

Automatically assigned by IRS or manually assigned by a system-level user, this status stops the Registry from activating a Domain in DNS which means that the domain name will not resolve. This status cannot be assigned to Contacts or Hosts.

serverRenewProhibited

This status prevents Domains from being renewed and cannot be assigned to either Contacts or Hosts. Note: A domain with the serverRenewProhibited status is prevented from being subject to automatic renewal.

serverTransferProhibited

This status prevents Domains from being transferred and cannot be assigned to either Contacts or Hosts.

serverUpdateProhibited

This status prevents the object in the Registry from being modified and can be assigned to Domains, Contacts, or Hosts.

Pending Status Values

Pending status values are automatically assigned by IRS to indicate that an operation affecting an object has been started but has not been completed. Operations affecting objects in IRS can be delayed for a number of reasons such as a requirement for review and approval. As the values are assigned or removed automatically, they cannot be configured manually.

Pending Status Values

Status

Description

pendingCreate

The object has been initially created in IRS but its addition to the Registry has not been completed. This status can be assigned to Domains or Contacts.

pendingDelete

The object is in the process of being deleted in IRS but its removal from the Registry has not been completed. This status can be assigned to Domains, Contacts, or Hosts.

pendingRenew

The renewal of a domain has been initiated in IRS but has not been completed. This status cannot be assigned to Contacts or Hosts.

pendingTransfer

The transfer of a domain has been initiated in IRS but has not been completed. This status can be assigned to Domains, Contacts, or Hosts.

pendingUpdate

Modification of the properties of an object has been initiated in IRS but has not been completed. This status can be assigned to Domains, Contacts, or Hosts.

Domain Lifecycle Status

The IRS registry platform implements a domain life cycle in accordance with Section 3.1 of RFC 3915

The stages/states of a domain life cycle are (Note. EPP status codes in brackets):

Domain Lifecycle

EPP Status Code

Description

OTE Setting

Production Setting

Available

The domain name is available for registration.

N/A

N/A

addPeriod

This grace period is provided after the initial registration of a domain name. If the registrar deletes the domain name during this period, there is a refund for the cost of the registration and the domain goes straight to a pending delete state, skipping the redemption period

1 day

5 days

Registered (ok)

The domain name is registered and active, it has no pending operations or prohibitions.

Renew period (renewPeriod)

The grace period after a domain has been explicitly renewed by the Registrar. This grace period following a domain name renewal allows the Registrar to delete the domain if necessary and obtain a credit for the cost of the renewal.

1 day

5 days

Auto-renew period (autoRenewPeriod)

This grace period occurs after a domain has been automatically renewed by the Registry. If the domain is deleted during this period, there is a refund for the cost of the renewal.

1 day

45 days

Redemption period (redemptionPeriod)

The grace period following the deletion of a domain name from the Registry. During this period, the domain name no longer resolves and cannot be renewed but the Registrar has the option to use the restore command to return the domain name to the registered state.

2 days

90 days

Pending Restore (pendingRestore)

The period during which a domain name is in the process of being restored to the Registry after having been in the redemptionPeriod stage. i.e. the pending restore period is the time allowed between posting a restore request and a restore report. If a restore report is not received then the domain returns to a redemption state.

5 days

5 days

Pending Delete (pendingDelete)

 A successful Domain Delete request transitions a domain object into pending delete state within the Registry. (A domain name that has been deleted transitions from registered, to redemption, and then to pending delete.) In the pending delete state, the domain name cannot be renewed or restored under any circumstances and is in the process of being removed from the Registry database to become available when the period ends. NOTE pendingDelete is a lifecycle state and a domain server status. When a domain is deleted it goes into the redemptionPeriod life cycle state and is assigned a server status of pendingDelete. When a domain has completed the redemptionPeriod it goes into the pendingDelete life cycle state and has a server status of pendingDelete until the domain Object Status is made available.

0 days

0 days

Transfer Period (transferPeriod)

This grace period is provided after the successful transfer of a domain name from one registrar to another. It’s used when there is a charge for a registrar transfer and the grace period is the time when the transfer can be undone and a registry refund for the transfer is applied. Under .nz policy there is no charge for the cost of a transfer of a .nz domain name, therefore this grace period is set to 0 days. A renewal fee will be charged if the term of .nz domain name has been extended as part of a transfer from one Registrar to another, however please note the Renewal Grace Period will not apply. This means if the domain is deleted immediately after the transfer there will be no refund on the renewal fee.

0 days

0 days