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)
command         = AddDomain
domain          = yourdomain.eco
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0	= (NAMESERVER)
nameserver1 	= (NAMESERVER)

After a successful registration of the domain, it will be transfer locked from the registry for a period of 60 days.

After registering a .eco domain, registrants will be invited to create a .eco profile to activate their .eco domain.
.eco profile activation flow:

  1. Invitation to activate profile
    • Email 1: Invitation to activate .eco profile
    • Sent from: activate@profiles.eco
    • Sent because: .eco domain was purchased
    • Subject: Activate yourdomain.eco
    • Reminders: Yes
    • Reminder days
    • 1-3---7------14----------30
  2. Sign up for .eco user account
    • Email 2: .eco account creation
    • Sent from: activate@profiles.eco
    • Sent because: .eco user account successfully created
    • Subject: Welcome to .eco!
    • Reminders: Yes
    • Reminder days
    • |-3---7------14----------30
  3. Enter .eco profile information
    • You: Domain owner + organisation type (if applicable)
    • What are you doing now?: Focus and/or sustainability actions
    • Enter your location(s)
    • Take the .eco pledge
  4. .eco profile is active
    • Email 3: .eco profile activation complete
    • Sent from: activate@profiles.eco
    • Sent because: .eco profile is complete and domain is now active
    • Subject: yourdomain.eco is now active!
    • Reminders: No

Domain Modification

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

Domain Renewal

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

Domain Deletion

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

Domain Transfer

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

Transfer procedure

  • After the transfer has been requested, our backend system sends a confirmation email to the Owner/Admin-C according to the WHOIS of the respective domain. In order to initiate the transfer successfully it is important, that this email is confirmed.
  • After confirmation the transfer is initiated through the official registry and the losing registrar will receive the transfer request.
  • The losing registrar will also send an email to the Owner/Admin-C. allowing him/her to deny the transfer. If you do not respond to the email of the losing registrar, then the transfer will get processed successfully after 5 days.

If the Email-Address in the WHOIS is invalid, then the transfer cannot be processed.If this is the case, then kindly contact your current registrar and ask him to update the WHOIS information accordingly.

Transfer notes

  • A .eco domain transfer must be initiated with a so-called authorisation code, which can be obtained from the current registrar through the owner or Admin-C of the domain.
  • Ensure that your respective domain does not have a lock-status (REGISTRAR-LOCK or HOLD). This can be seen in the WHOIS.
  • If the domain is locked, then the owner can demand that the domain will be unlocked.
  • Please note that we are only allowed to initiate a gTLD transfer after confirmation of the "ICANN Form of Authorization" by the current registrant. The policies can be viewed under http://www.icann.org/transfers/
  • After a successful transfer of the domain, it will be transfer locked from the registry for a period of 60 days.


The format for auth info requires a minimum length of 6 characters and a maximum length of 16 characters.

Additionally, auth info must contain at least one of each of the following three character types:

  • Alphabetic characters: a-z; A-Z
  • Numeric characters: 0-9
  • Special characters: -

Domain Restore

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

Domain Restrictions

Creation of .eco profile.

Wedomains :)