RRPproxy Homepage
RRPproxy Homepage


API commands

Please find in the following a set of the most commonly used standard API commands in order to register, modify, renew, and transfer a domain name.

Domain Registration

(API Command reference » AddDomain)

.new is an encrypted-by-default TLD by virtue of being inscribed in the HSTS Preload list. As such, all second-level domains under .new will only load on modern browsers if a valid SSL certificate has been configured and the web server is serving HTTPS. This behavior of .new must be clarified to registrants. A respective notification must be integrated as part of the registration flow and presented prior to purchase. It cannot be embedded in other terms of service, nor require the registrant to follow a link to obtain the information. You may use the following sample text of the registry for the notice. On demand of the registry, the reseller will have to provide screenshots of the purchase flow including the notice. You have to confirm that you have understood and will comply to these requirements by transmitting the parameter X-ACCEPT-SSL-REQUIREMENT = 1.

Sample text:
.new is a more secure domain, meaning that HTTPS is required for all .new websites. You can buy your .new domain name now, but in order for it to work properly in browsers you must first configure HTTPS serving. For more information about configuring HTTPS, including resources to obtain an SSL certificate, please visit [link to registrar page on SSL, or Let’s Encrypt]. [Follow by registrar option to add certificate to cart.]

Please note: The SSL requirement is enforced at the browser level, so there is no mandated order of purchase. The HSTS Preload list, to which .new is inscribed, only forces encryption on HTTPS connections, thus, .new domain names that do not have an SSL certificate configured may still be used for other services like e-mail and non-browser based uses such as defensive registrations.

command = AddDomain
domain = yourdomain.new
period = 1
ownercontact0 = (CONTACT)
admincontact0 = (CONTACT)
techcontact0 = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0 = (NAMESERVER) | (NULL)
nameserver1 = (NAMESERVER) | (NULL)

Domain Modification

(API Command reference » ModifyDomain)
command = ModifyDomain
domain  = yourdomain.new

Domain Renewal

(API Command reference » RenewDomain)
command    = RenewDomain
domain     = yourdomain.new
period     = (INT)
expiration = (INT)

Domain Deletion

(API Command reference » DeleteDomain)
COMMAND = DeleteDomain
DOMAIN = yourdomain.new

Domain Transfer

(API Command reference » TransferDomain)
command = TransferDomain
domain = yourdomain.new
action = REQUEST
auth = (TEXT)

Domain Restore

(API Command reference » RestoreDomain)
command = RestoreDomain
domain  = yourdomain.new

Domain Extensions


Confirmation that the process required for the registration is implemented on the reseller side and the respective options are presented to the registrant prior to the registration.
X-ALLOCATION-TOKENProvide a token that has to be issued by the registry for the registration of a premium domain name.

Domain Restrictions

Registration Policy Notice:
Registrars are required to display a notice to registrants stating the use restrictions for .new.

Sample text:
.new is a restricted domain space in which all domains must be used for action generation or online content creation flows. .new domains must be active within 100 days from the registration date. Domain names that do not comply with these requirements may be placed on ServerHold or deleted for non-compliance.

Supported IDN Scripts

The following IDN scripts are supported by .new.
Provide the LANGUAGE TAG corresponding to your desired IDN within the AddDomain command as X-IDN-LANGUAGE extension.


Get more information of "IDN tables", which represent permitted code points (letters) allowed for Internationalised Domain Name registrations in particular registries on IANA Repository of IDN Practices.

Wedomains :)