CentralNic Reseller Homepage
CentralNic Reseller Homepage

.swiss

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)

The challenge process consisting of initial evaluation of the applied for domain names by the registry and publication of the registration applications for 20 days on the registry page still applies even after the Golive of the .swiss TLD. Other interested parties may submit competing domain name applications during this 20-day period. It is also possible to notify the registry of any problem in relation to the submitted registration application. Moreover, there are special requirements for generic domain names (naming mandate).

This means that all (multiple) registration applications will be processed in non real-time and reviewed and validated by the registry. They remain in the status "Pending" up to the final allocation or rejection.

Because of this situation and to allow multiple registration applications for the same domain name, we have decided to deactivate the regular AddDomain command for .swiss as of February 22, 2016. Instead, we will only accept AddDomainApplications in order to correctly map this complicated registration procedure in our system.

Exception
command         = AddDomainApplication
class           = SWISS-GOLIVE
domain          = yourdomain.swiss
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0	= (NAMESERVER)
nameserver1 	= (NAMESERVER)
X-INTENDED-USE  = (TEXT)
X-SWISS-UID     = (TEXT)

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

Domain Modification

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

Domain Renewal

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

Domain Deletion

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

Domain Transfer

(API Command reference » TransferDomain)
Command
command = TransferDomain
domain = yourdomain.swiss
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 .swiss 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.swiss

Domain Extensions

X-INTENDED-USE* Statement of intended use for the domain name including explicit reference to the applicants' claimed right to the name (if not the corporate name of the applicant)

* For example, if the domain name matches a trademark, the TM number must be provided

* max. 256 characters
X-SWISS-UIDEnterprise ID of the registrants organisation

Domain Restrictions

To register and renew a .swiss domain name You must fulfill all the following requirements:

  • a. You must be a legal entity (i.e. not an individual) with sufficient link to Switzerland. This occurs if You are:
    • i. A public body or another public organization under Swiss public law;
    • ii. A legal entity registered in the Swiss Commercial Register having its seat in Switzerland and an effective site of administration in Switzerland; or
    • iii. An association or foundation not registered in the Swiss Commercial Register having its seat and an effective site of administration in Switzerland.
  • b. At the time of the application, the requested name belongs to a category of names available for allocation.
  • c. The intended use is legal under Swiss law. Be aware that if the domain name is used to provide products or services or to advertise them, a seat and an effective place of administration are required.
  • d. The name applied for can legitimately be considered as objectively linked to the applicant or the intended use of the domain name. This occurs in particular if the domain name satisfies one of the following conditions:
    • i. it contains a name for which the applicant holds a trademark right;
    • ii. it refers to a name objectively linked to the State or its activities that is required by the respective public body or the public law organization concerned;
    • iii. it contains a geographical designation, or a clear variation or abbreviation of a name, to which the applicant has a legitimate right or interest, to which it has a legitimate right or interest in the public mind, or it is authorized to use by the public body or bodies or other organizations concerned;
    • iv. it reflects a name in which the applicant has a legitimate interest or which is associated with the applicant in the public mind; and
  • e. The requested name is not a "Designation with a Generic Character", without prejudice to be eligible under the Registries naming mandate program as set forth in Section 6 of this Registration Policy.

In exceptional cases, the Registry may allocate domain names which do not meet the eligibility requirements set forth in this Section when the interest of this allocation for the Swiss community so justifies.

Please read the Registration Policy for further information:

.swiss-Registration-Policy

The .swiss registry validation team had determined that a registered branch of a foreign company is not eligible for .swiss registrations.

Registrant Eligiblity criteria for the .swiss TLD are set forth in Art. 55 (1) of the Federal Ordinance on Internet Domains (OID) and in Art. 4 of the Federal Ordinance on .swiss. The eligibility of private institutions is constrained as follows:

  • entities entered in the Swiss commercial register having their headquarters and an actual administrative site in Switzerland;
  • associations and foundations not entered in the Swiss commercial register having their headquarters and an actual administrative site in Switzerland.

As a branch of a foreign company does not a have separate legal personality, the relevant headquarters are not in Switzerland. This means that branches of foreign companies are not eligible for .swiss registrations.

Unfortunately, during the .swiss launch period, a small number of applications by branch offices of foreign companies were allocated by error. The .swiss registration team has determined that these allocations "will be revoked unless the original applicant re-assigns the domains to an eligible party".

Special procedures for name space mandates(NSMs)

Generic names may be allocated in the form of name space mandates (NSM). NSMs are described under Article 56 of the Federal Ordinance on Domain Names:

A single NSM may comprise many domains. Applicants for NSMs must submit a proposal. Proposals for NSMs can be submitted in response to a Call for Proposals or spontaneously. Multiple domain names for a given purpose may be combined in a single mandate. As the pricing for NSMs is on a per-mandate basis rather than a per-domain basis, the average price per domain invoiced may be considerably lower (or higher) than the price for standard domain registrations. The key criteria for selection for an NSM is best service to the community. The mandate holder can select a registrar. The registrar can submit or take over NSM registrations after the negotiations between the registry and the mandate holder are complete, based on an exhaustive listing of domains belonging to the mandate and the use of authorization codes. A mandate may be subject to additions or removals of domain names.

Supported IDN Scripts

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

LatinLATN

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.

We domains
-