CentralNic Reseller Homepage
CentralNic Reseller Homepage

.eco

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
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

To resend the activation email manually, the registry also provides a tool via https://profiles.eco/user/resend-email.

Domain Modification

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

Domain Renewal

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

Domain Deletion

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

Domain Transfer

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

Transfer procedure

  • The transfer is submitted to the registry and the losing registrar is automatically notified by them.
  • The losing registrar sends an email to the owner (and optionally admin) contact, informing about the transfer; this may include options to approve and/or deny the transfer. If neither explicitly approved nor denied, the transfer will be automatically finalized after 5 days.

Transfer notes

  • A .eco domain transfer must be initiated with a so-called authorisation code, (auth-code) which can be obtained from the current registrar through the owner/admin contact of the domain.
  • Ensure that your respective domain does not have a lock-status (clientTransferProhibited and/or serverTransferProhibited). This can be seen in WHOIS.
  • If the domain has a client-side transfer lock, the owner can ask the current registrar to have the lock removed.

These procedures only apply for domain transfers between registrars. For internal transfers between resellers, please consult our documentation about internal transfers/usertransfers.

Auth-Codes

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
command = RestoreDomain
domain  = yourdomain.eco

Domain Restrictions

Creation of .eco profile.

We domains
-