.tel

API commandsExtensionsRestrictionsIDN

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)

Command

command         = AddDomain
domain          = yourdomain.tel
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0  = (NAMESERVER)
nameserver1   = (NAMESERVER)

• From March 13, 2017, Telnic will assume the responsibility for the Community Telhosting system(CTH) and the registrars will no longer need to provide this support service. Thus, any Telhosting customer support requests should be referred to Telnic Support at [email protected] and they will handle them directly.
• The registry will not be offering sub domain functionality in the new Telhosting platform(managemy.tel). Should your customers wish to continue to host their domain on a similar version to the current Telhosting platform which incorporates sub domains, they are required to contact the registry at [email protected] in order to discuss the available options.

Domain Modification

(API Command reference » ModifyDomain)

Command

command = ModifyDomain
domain  = yourdomain.tel

Domain Renewal

(API Command reference » RenewDomain)

Command

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

Domain Deletion

(API Command reference » DeleteDomain)

Command

COMMAND = DeleteDomain
DOMAIN = yourdomain.tel

Domain Transfer

(API Command reference » TransferDomain)

Command

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

Auth-Codes

The format for auth info requires a minimum length of 8 characters and a maximum length of 32 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.tel

The restore request will be manually processed by our support team. You will be notified by email.

Domain Extensions

X-TEL-PUBLISH-WHOIS	0 | 1 | NULL Hide/Show private details in the whois, only available for private persons
X-TEL-WHOIS-PHONE	| NULL The phone number of the reseller to be shown in the WHOIS. This needs to be in the format +XX.XXXXXXXXX and will only be shown if X-WHOIS-RSP is set.
X-TEL-WHOISTYPE	Natural | Legal | Defines what type of user the registrant is: Natural person or Legal person (i.e. a company)

Domain Restrictions

• Premium domain names
  • all 3-character numeric domains
  • all 3-character letter domains
  • all 4-character numeric domains
  • all 4-character letter domains
  • and a limited number of mixed numeric and letter 3 / 4-character domains

Supported IDN Scripts

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

Arabic	AR
Chinese	ZH
Danish	DA
Dutch Flemish	NL
French	FR
German	DE
Italian	IT
Japanese	JA
Korean	KO
Polish	PL
Spanish	ES
Swedish	SV

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.