.aero

API commandsExtensionsRestrictions

Important

Starting with 2023-11-10, the registry no longer accepts registrations or renewals of .AERO domains, for registrants originating from the following countries or teritorries: Belarus, Cuba, Iran, Russia, Syria, North Korea, Venezuela, and the disputed ukrainian territories of crimea, Donetsk, Luhansk, Kherson and Zaporizhzhia.

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.

AddDomainModifyDomainRenewDomainDeleteDomainTransferDomainRestoreDomain

Domain Registration

(API Command reference » AddDomain)

Exception

command         = AddDomain
domain          = yourdomain.aero
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0  = (NAMESERVER)
nameserver1   = (NAMESERVER)
X-AERO-ENS-AUTH-ID  = (TEXT)
X-AERO-ENS-AUTH-KEY = (TEXT)

Exception

command             = AERO_CheckENS
X-AERO-ENS-AUTH-ID  = (TEXT)
X-AERO-ENS-AUTH-KEY = (TEXT)

This command performs a check, if the additional parameters for .aero registrations are valid.

Domain Modification

(API Command reference » ModifyDomain)

Standard command

command = ModifyDomain
domain  = yourdomain.aero

Change of Registrant

Exception

command         = ModifyDomain
domain          = yourdomain.aero
ownercontact0   = (CONTACT)
X-AERO-ENS-AUTH-ID  = (TEXT)
X-AERO-ENS-AUTH-KEY = (TEXT)

A change of registrant can be initiated via ModifyDomain command, including the new ownercontact as well as the new extensions.

Domain Renewal

(API Command reference » RenewDomain)

Command

command    = RenewDomain
domain     = yourdomain.aero
period     = (INT)
expiration = (INT)

Domain Deletion

(API Command reference » DeleteDomain)

Command

COMMAND = DeleteDomain
DOMAIN = yourdomain.aero

Domain Transfer

(API Command reference » TransferDomain)

Command

command = TransferDomain
domain = yourdomain.aero
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 .aero 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.aero

Domain Extensions

X-AERO-ENS-AUTH-ID	The .AERO ID which can be applied for at https://www.information.aero/node/add/request-aero-id (mandatory)
X-AERO-ENS-AUTH-KEY	The respective AuthCode provided from the https://www.information.aero/node/add/request-aero-id website at the same time as the .AERO ID (mandatory)

Domain Restrictions

You need an ID and respective password in order to register a .aero domain name. Please see the website of the registry for further information.