Premium Domains

Updated listing of new generic Top-Level-Domains (TLD), TLD registration profiles, and API commands. It’s been a long thought out idea since 1984 to broaden the Internet’s domain name space, and was finally deployed starting late 2013. Directory includes new gTLDs, Geographic TLDs and IDN TLDs.

TLD availability varies depending on the launch periods for Sunrise, Landrush / Early Access, and Go Live. Please see the Launch Calendar for more details.

APIs

Create a new Sunrise Application

REQUIRED

command = AddDomainApplication
class = (TLD)_SUNRISE
domain = (DOMAIN)
ownercontact0 = (CONTACT)
admincontact0 = (CONTACT)
techcontact0 = (CONTACT)
billingcontact0 = (CONTACT)
SMD0 = -----BEGIN ENCODED SMD-----
SMD1 = PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8+PHN
SMD2 = tZDpzaWduZWRNYXJrIHhtbG5zOnNtZD0idXJuOmlldGY6cGFyYW1zOnhtbDpuczpzaWduZWRNYX
SMD3 = JrLTEuMCIgaWQ9InNpZ25lZE1hcmsiPgogIDxzbWQ6aWQ+MS01NjY1Nzwvc21kOmlkPgogIDxzb
SMD4 = WQ6aXNzdWVySW5mbyBpc3N1ZXJJRD0iMyI+CiAgICA8c21kOm9yZz5NYXJrIFZhbGlkYXRvcjwv
SMD5 = c21kOm9yZz4KICAgIDxzbWQ6ZW1haWw+bWFya3ZhbGlkYXRvckBtYXJrdmFsaWRhdG9yLmNvbTw
SMD6 = vc21kOmVtYWlsPgogICAgPHNtZDp1cmw+aHR0cDovL3d3dy5tYXJrdmFsaWRhdG9yLmNvbTwvc2
SMD7 = 1kOnVybD4KICAgIDxzbWQ6dm9pY2UgeD0iMTIzNCI+KzQzLjg4ODg5OTk5PC9zbWQ6dm9pY2U+C
SMD8 = ...

Create an Early Access Program Application

REQUIRED

command = AddDomainApplication
class = <TLD>_EARLYACCESS1
domain = <DOMAIN>
ownercontact0 = <CONTACT>
admincontact0 = <CONTACT>
techcontact0 = <CONTACT>
billingcontact0 = <CONTACT>

the same command can be used with these classes:

OPTIONAL

<TLD>_EARLYACCESS2
<TLD>_EARLYACCESS3
<TLD>_EARLYACCESS4
<TLD>_EARLYACCESS5

Create a GoLive Application

REQUIRED

command = AddDomainApplication
class = <TLD>_GOLIVE
domain = <DOMAIN>
ownercontact0 = <CONTACT>
admincontact0 = <CONTACT>
techcontact0 = <CONTACT>
billingcontact0 = <CONTACT>

Converting EOIs to Applications

In order to convert an EOI to a domain application by API you simply have to create your domain application using the API commands above adding the following parameter:

OPTIONAL

EOI = <YOUR-EOI-APPLICATION-ID>

- You can only use your EOI once in order to create one domain application for a matching domain

- Also if you create several domain applications for the same domain but different launch phases it is only possible to convert one EOI to one application

Convert an EOI for example.bike to an Early Access Program Application for day 3:

command = AddDomainApplication
class = BIKE_EARLYACCESS3
domain = example.bike
ownercontact0 = <CONTACT>
admincontact0 = <CONTACT>
techcontact0 = <CONTACT>
billingcontact0 = <CONTACT>
eoi = 12345

Claim notice

CheckDomain - CheckDomain with phase "CLAIMS"

The following API command will return if there are claims for dedicated domains INSTEAD of returning the availability of the domain. There will be no indication if a domain name is available for registration. Only if there exist claims for a domain name or not:

REQUIRED

[COMMAND]
command = CheckDomain
domain = example.bike
phase = claims
EOF

[RESPONSE]
PROPERTY[CLAIMKEY][0]=2014010100/0/1/a/ABCDEFG123456789
DESCRIPTION=Claim exists
CODE=211
EOF 

Querying the trademark notice and notice id

The claimkey can be used to query trademark details with the StatusTMDBClaim command. Response parameters are:

• NOTICE-CREATEDDATE
• NOTICE-XML
• NOTICE-TEXT
• NOTICE-ACCEPT-ID
• NOTICE-EXPIRATIONDATE

REQUIRED

[COMMAND]
command = StatusTMDBClaim
claimkey = 2014010100/0/1/a/ABCDEFG123456789
EOF

[RESPONSE]
CODE=200
DESCRIPTION=Command completed successfully
PROPERTY[NOTICE-ACCEPT-ID][0]=5adc112f0000000000008912290
PROPERTY[NOTICE-CREATEDDATE][0]=2014-02-04 00:00:00
PROPERTY[NOTICE-EXPIRATIONDATE][0]=2014-02-06 00:00:00 
...

AddDomain

In order to register a claims domain you have to provide at least two parameters:

• NOTICE-EXPIRATIONDATE
• NOTICE-ACCEPT-ID
• NOTICE-ACCEPTEDDATE (optional)

REQUIRED

[COMMAND]
command = AddDomain
domain = example.bike
NOTICE-ACCEPT-ID = 5adc112f0000000000008912290
NOTICE-EXPIRATIONDATE = 2014-02-04 00:00:00
...

Premium Domains

Below you will find an example "CheckDomains" command for a so called "Premium" domain:
REQUIRED

[COMMAND]
command = CheckDomains
domain0 = <TEXT>
premiumchannels = *
EOF

[RESPONSE]
PROPERTY[PREMIUMCHANNEL][0]=RIGHTSIDE
PROPERTY[PRICE][0]=xx.xx
PROPERTY[REASON][0]=Premium Domain Name
PROPERTY[DOMAINCHECKTIME][0]=0.032
PROPERTY[CLASS][0]=PREMIUM_RIGHTSIDE_P
PROPERTY[CURRENCY][0]=USD
PROPERTY[DOMAINCHECK][0]=211 Premium Domain name available [PREMIUM]
DESCRIPTION=Command completed successfully
CODE=200
QUEUETIME=0.001
RUNTIME=0.208

The "CLASS" parameter have to be used at the AddDomain command:

command = AddDomainApplication
class = PREMIUM_RIGHTSIDE_P
...

In order to query the renewal price of a dedicated domain of your portfolio you can extend the StatusDomain command as follows. This is also possible for premium domains:
REQUIRED

[COMMAND]
command = StatusDomain
domain = <DOMAIN>
properties = PRICE
EOF

[RESPONSE]
...
PROPERTY[CURRENCY][0]=EUR
PROPERTY[RENEWALPRICE][0]=10.00
PROPERTY[RENEWALGROSSPRICE][0]=11.90
PROPERTY[VAT][0]=19.00
...
EOF