domorder

Domain Products

Sunrise Period

When new Top-Level Domain (TLD) extensions are being launched, they typically begin with a 30 to 60 day period called Sunrise Period. During the Sunrise Period, Domain Names can not be registered by the general public, but only by those who hold a Trademark for a particular string or term. This allows Trademark holders to secure the domain name that matches their Trademark, and prevents it from being registered for fraudulent or malicious purposes.

In the Sunrise Period, the Registration of a Domain Name requires the applicant to provide some proof of their Trademark matching the name being registered. The exact proof required depends on the Registry that operates that TLD. The allocation of Domain Names also depends on the Registry itself - a Domain Name may be allotted on first come, first serve basis, or at the end of the Sunrise period. In the latter case, if there are multiple applicants with a valid Trademark for a particular string, the Domain Name may be put up for a private auction where both applicants would bid for the right to register the Domain Name.

Note

Sunrise Registrations do not give the Registrant a perpetual claim over the Domain Name. The Registrant is expected to renew the Domain Name to maintain their Registration just like any other Domain Name failing which it would become available for anyone to register.

About the Trademark Clearinghouse (TMCH)

Starting October 2013, the Sunrise Period for any new Generic Top-Level Domain (gTLD) is expected to be served through a special Trademark Clearinghouse (TMCH) as mandated by ICANN, the governing body for Domain Names. A Trademark holder who wishes to register their Trademark name with any new gTLD is expected to first register their Trademark with the TMCH. When the TMCH reviews and validates their Trademark, the holder is allotted a Signed Mark Data (SMD) file that acknowledges their Trademark. This SMD file must be used by the holder as their proof while registering Domain Names in the Sunrise Period for any new gTLD that launches. The Trademark holder is not expected to supply any additional proof if they have a valid SMD file.

Additional Information

Trademark Clearinghouse

Note

The TMCH-faciliated Sunrise process is mandatory for Generic Top-Level Domain extensions. Country-code TLD extensions (ccTLDs) are not expected to rely on the TMCH for validating Sunrise Registration requests.

About the Signed Mark Data (SMD) File

The SMD file contains the below details:

  • Marks: The Trademark(s) that the SMD file refers to

  • smdID: A unique identifier for the SMD file

  • U-labels: The strings that the Trademark holder can use to register domain names in the Sunrise Period

  • notBefore: The start of validity of the SMD file

  • notAfter: The end of validity of the SMD file

  • Encoded SMD file: The actual SMD file is encoded between -----BEGIN ENCODED SMD----- and -----END ENCODED SMD-----. You should not modify your SMD file, as this may render the SMD file invalid.

Sample SMD File


Marks: Tm1 & Tm2

smdID: 001234

U-labels: tm1-tm2, tm1tm2

notBefore: 2013-12-09 09:00

notAfter: 2017-11-24 09:00

-----BEGIN ENCODED SMD-----

PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHNtZDpzaWdu

ZWRNYXJrIHhtbG5zOnNtZD0idXJuOmlldGY6cGFyYW1zOnhtbDpuczpzaWduZWRN

[...]

cnRpZmljYXRlPgo8L1g1MDlEYXRhPgogICAgPC9LZXlJbmZvPgogIDwvU2lnbmF0

dXJlPgo8L3NtZDpzaWduZWRNYXJrPgo=

-----END ENCODED SMD-----

Check Availability - Sunrise

Description

Checks the availability of the specified Domain Name(s) in the Sunrise Phase.

Parameters

Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
domainname String Required Domain Name that you need to check the availability for in the Sunrise period
tld Array of Strings Required TLD(s) for which the Domain Name availability needs to be checked
smd String Required Pass the content of the smd file

HTTP Method

GET

Example Test URL Request


https://domaincheck.httpapi.com/api/domains/available-sunrise.xml?auth-userid=0&api-key=key&domainname=domain1&tld=bike&smd=<smd_file_content>

Response

Returns a hash map containing Domain Name availability status for the requested TLDs:

  • available - Domain Name available for registration

  • regthroughus - Domain Name currently registered through the Registrar whose connection is being used to check the availability of the Domain Name

  • regthroughothers - Domain Name currently registered through a Registrar other than the one whose connection is being used to check the availability of the Domain Name. If you wish to manage such a Domain Name through your Reseller / Registrar Account, you may pass a Domain Transfer API call. See details

  • unknown - returned, if for some reason, the Registry connections are not available. You should ideally re-check the Domain Name availability after some time.

Fetch Wishlist TLDs based on Category

Description

Fetches the TLDs for the specified Category.

Parameters

Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
category String optional The Category for which the TLDs are to be fetched. Values can be adult, arts and media, beauty and fashion, business and commerce, education, finance, food and drink, generic, geo cultural, government and politics, health, idn, news and information, novelty, people and lifestyle, real estate, religion, services, sports and games, technology or travel.

HTTP Method

GET

Example Test URL Request


https://test.httpapi.com/api/domains/preordering/fetchtldlist.xml?auth-userid=0&api-key=key&category=services

Response

Returns a hash map containing the below details:

  • Fetch TLDs Action Status (status)

  • Fetch TLDs Action Status Description (status_description)

  • Fetched TLDs Information (response_value)

In case of any errors, a status key with value as ERROR alongwith an error message will be returned.

Fetch Wishlist

Description

Fetches the Wishlist.

Parameters

Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
customerid Integer Optional Customer ID of the Customer for whom the Wishlist is to be fetched
resellerid Integer Optional Reseller ID of the Reseller for whom the Wishlist is to be fetched
domain Array of Strings Optional Domain Name(s) for which the Wishlist is to be fetched
tld Array of Strings Optional TLD(s) for which the Wishlist is to be fetched
creation-date-start String Optional UNIX TimeStamp for listing of Wishlist entries whose Creation Date is greater than creation-date-start
creation-date-end String Optional UNIX TimeStamp for listing of Wishlist entries whose Creation Date is less than creation-date-end
no-of-records Integer Required Number of records to be returned
page-no Integer Required Page number for which records are required

HTTP Method

GET

Example Test URL Request


https://test.httpapi.com/api/domains/preordering/fetch.xml?auth-userid=0&api-key=key&no-of-records=10&page-no=1

Response

Returns a hash map containing the below details:

  • Fetch Wishlist Action Status (status)

  • Fetch Wishlist Action Status Description (status_description)

  • Wishlist Details (response_value)

    • Domain Name (domainname)

    • TLD associated with the Domain Name (tld)

    • Category under which the TLD is included (category)

    • Wishlist Entry Creation Time (creation_time)

    • Customer ID of the Customer under whom the Wishlist exists (customerid)

    • Reseller ID of the Reseller under whom the Wishlist exists (resellerid)

In case of any errors, a status key with value as ERROR alongwith an error message will be returned.

Delete Domain Names from Wishlist

Description

Deletes the specified Domain Name(s) from the Wishlist.

Parameters

Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
customerid Integer Required Customer ID of the Customer for whom you wish to delete the Wishlist entry
domain Array of Strings Required Domain Name(s) which need to be deleted from the Wishlist

HTTP Method

POST

Example Test URL Request


https://test.httpapi.com/api/domains/preordering/delete.xml?auth-userid=0&api-key=key&customerid=0&domain=domain1.ads

Response

Returns a hash map containing the below details:

  • Wishlist Entry Deletion Action Status (status)

  • Wishlist Entry Deletion Action Status Description (status_description)

  • Invalid Domain Name(s) (invalid_domains)

In case of any errors, a status key with value as ERROR alongwith an error message will be returned.

Add Domain Names to Wishlist

Description

Adds the specified Domain Name(s) to the Wishlist.

Parameters

Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
customerid Integer Required Customer ID of the Customer for whom the Wishlist needs to be created / updated
domain Array of Strings Required Domain Name(s) which need to be added to the Wishlist

HTTP Method

POST

Example Test URL Request


https://test.httpapi.com/api/domains/preordering/add.xml?auth-userid=0&api-key=key&customerid=0&domain=domain1.ads

Response

Returns a hash map containing the below details:

  • Wishlist Create / Update Action Status (status)

  • Wishlist Create / Update Action Status Description (status_description)

  • Invalid Domain Name(s) (invalid_domains)

In case of any errors, a status key with value as ERROR alongwith an error message will be returned.

Resend Registrant Contact Email Address Verification Email

Description

Resends the verification email to the Registrant Contact Email Address for the specified Domain Registration Order.

Parameters

Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
order-id Integer Required Order Id of the Domain Registration Order for which you wish to resend the verification email

HTTP Method

POST

Example Test URL Request


https://test.httpapi.com/api/domains/raa/resend-verification.xml?auth-userid=0&api-key=key&order-id=0

Response

Returns true (Boolean) if the action is executed successfully; false otherwise.

In case of any errors, a status key with value as ERROR alongwith an error message will be returned.

Whois Data Verification

As per the Whois Data Accuracy Specification introduced by Internet Corporation For Assigned Names and Numbers [ICANN] and effective from 1 January, 2014, every Registrar is required to verify the email address of the Registrant contact for each gTLD domain name, within 15 days of:

  • a domain name being registered with unverified Registrant Contact email address,

  • a domain name being transferred in from another Registrar,

  • the Registrant Contact being replaced by a Contact with an unverified email address,

  • the email address of the Registrant Contact being modified to an unverified email address,

    OR

  • an unverified email address being associated with a domain name, after the domain name is moved to another Account.

The gTLDs for which this requirement is applicable are:

  • .ASIA


  • .BIZ


  • .COM


  • .INFO


  • .JOBS


  • .MOBI


  • .NAME


  • .NET


  • .ORG


  • .PRO


  • .SHABAKA


  • .TEL


  • .US


  • .XXX


  • Donuts Domains See details

Accordingly, an email would be sent from the system to the Registrant Contact email address for verification, upon one of the above actions being performed.

If the Registrant Contact does not complete the verification process within 15 days, the domain name would be deactivated. It would then resolve to a page indicating the reason for the deactivation, alongwith instructions to activate the domain name. The domain name would be activated, once the verification has been completed.

During this 15 days duration as well as upon deactivation, it would be possible from within the Registrar Reseller / Customer Control Panel to:

  • update the Registrant Contact Details See details,

    AND / OR

  • re-send the verification email, in case the Registrant Contact has not received it.

To Re-send the Verification Email

  1. Login to your Control Panel. See details

  2. Search for the domain name and proceed to the Order Information
    view. See details

  3. Click the Resend Email / Resend Verification Email button.

For Registrars: You may choose to skip the verification process for a specific Order, if you have already verified the email address through some other means or if the email address belongs to you.

To Skip Verification or Remove Verification Hold

  1. Login to your Control Panel. See details

  2. Search for the domain name and proceed to the Order Information
    view. See details

  3. Click the Skip Verification button.

    In case of a Domain Registration Order Suspended due to failed verification, you may skip the verification process using the Remove Verification Hold button.

Note

The above requirement is applicable for all gTLD domain names registered after 1 January, 2014. Domain names registered / transferred prior to this date are not subject to this verification process, unless the associated Registrant Contact email address is modified to an unverified email address.