|
domorder
Domain Products
.EU Unavailability Notice: 15 December, 2010
Due to the following maintenance announced by the .EU Registry, the .EU Product would be offline as well:
Date: December 15, 2010
Time: 8:00 PM - 9:30 PM (2000 - 2130) GMT/UTC
Duration: 1.5 hours
Affected Systems: Domain Name Registrations, Renewals, Transfers, Management on our Live servers.
This outage shall have no impact on the resolution/working of your already registered domain names. Please feel free to get in touch with our Support Team
at , in case of any queries/doubts.
Suggest Names
Description
Returns domain name suggestions for a user-specified keyword.
Parameters
Name | Data Type | Required / Optional | Description |
---|---|---|---|
auth-userid | Integer | Required | Authentication Parameter |
api-key | String | Required | Authentication Parameter |
keyword | String | Required |
Search term (keyword or phrase) e.g. "search" or "search world" Note
|
tld-only | String | Optional | Specific TLD(s) you may want to search for See details
Note
Name Suggestion is not supported for ccTLDs except:
|
exact-match | Boolean | Optional | Will return keyword alternatives when set to True. Can be set to False to only return TLD alternatives. |
HTTP Method
GET
Example Test URL Request
https://test.httpapi.com/api/domains/v5/suggest-names.json?auth-userid=0&api-key=key&keyword=domain
Response
Returns a hash map containing availability status of suggested domain names for the keyword supplied.
Example Scenarios
-
When tld-only is not specified, and exact-match is false: Results will include keyword matches and alternatives against all TLDs the reseller is signed up for.
-
When tld-only is specified, and exact-match is false: Results will include keyword matches and alternatives against only the TLDs specified.
-
When tld-only is not specified, and exact-match is true: Results will include keyword matches against all TLDs that the reseller is signed up for. No keyword alternatives will be returned.
-
When tld-only is specified, and exact-match is true: Results will include keyword matches against only the TLDs specified. No keyword alternatives will be returned.
Old API call being deprecated
Parameters
Name | Data Type | Required / Optional | Description |
---|---|---|---|
auth-userid | Integer | Required | Authentication Parameter |
api-key or auth-password | String | Required | Authentication Parameter |
keyword | String | Required |
Search term (keyword or phrase) e.g. "search" or "search world" Note
The search term will be considered as invalid, if it contains more than one consecutive space character. |
tlds | Array of Strings | Required | Domain name extensions (TLDs) you want to search in See details |
no-of-results | Integer | Required | Maximum number of suggestions to be returned |
hyphen-allowed | Boolean | Optional | Default value is false. Recommended value is true. If true is passed, generates suggestions with hyphens (Dashes) "-". |
add-related | Boolean | Optional | Default value is false. Recommended value is true. If true is passed, generates suggestions with related keywords. |
HTTP Method
GET
Example Test URL Request
https://test.httpapi.com/api/domains/suggest-names.json?auth-userid=0&api-key=key&keyword=domain&tlds=com&tlds=net&no-of-results=0&hyphen-allowed=true&add-related=true
Response
Returns a hash map containing availability status of suggested domain names, for the given keyword under the specified domain name extension(s). The domain name extensions will be listed in alphabetical order.
Retrieving Transfer Authorization Details for domain names
As per ICANN's guidelines See details, every Registrar is required to maintain complete details of Transfer Authorization for every domain name being Transferred In.
The system maintains detailed records of authorization information of each successful Transfer In, under your account. This information would be particularly necessary in case of Transfer disputes, where the Losing Registrar would require these details to confirm that as the Gaining Registrar you received the domain name Owner's express authorisation to transfer his domain name.
To obtain the Details of any domain name that has been Transferred to your Registrar
-
Login to your Control Panel. See details
-
In the Menu, point to Products -> Domain Registration and click Transferred Domain Details.
-
Specify the domain name in the textbox besides Domain Name and click Submit.
-
Information about the Transferred In domain name would be displayed under the following heads:
-
Whois Details:
-
Registrar: This is the name of the Losing Registrar for the domain name, from whom the domain name was Transferred to you.
-
Whois Dump: This is the complete Whois details as retrieved from the Losing Registrar's Whois server.
-
Automatic:
-
T: True indicates that our Whois server automatically parsed the Whois details (mentioned above) by querying the Whois server of the Losing Registrar.
-
F: False indicates that our Whois server did not automatically obtain the Whois details (mentioned above) by querying the Whois server of the Losing Registrar, but instead these details were manually fed in the system by your Support Team.
Additional InformationProcessing Transfers where Admin Contact Email Address cannot be retrieved
-
-
-
FOA Details:
-
Participant E-mail Id: This is the email address of the Administrative Contact listed in the domain name at the time the Whois details were parsed from the Losing Registrar's Whois server.
-
HTTP Headers: This represents the information retrieved from the Administrative Contact's web browser. Of special importance are:
-
Referer: This represents the hyperlink that the Administrative Contact clicked to approve the Transfer request.
-
Client IP Address: This is the IP Address of the Administrative Contact when the Transfer was approved.
Note-
The HTTP Headers field will display Transfer processed via Fax if the domain name Owner approves the Transfer by sending a Transfer Fax Form to you, instead of using the authorization link contained in the e-mail.
-
Transfers approved via the Transfer Fax Form prior to 27th March 2008, will display RFA confirmed by Fax approval in the HTTP Headers field.
-
If the Losing Registrar requests the FOA Details related to a Transfer approved by a Transfer FAX Form, you should inform the Losing Registrar that the Transfer was approved after receiving an offline authorization in the form of a fax from the domain name Owner.
-
-
Time (GMT/UTC): This is the timestamp in GMT/UTC when the Administrative Contact approved the Transfer to your Registrar.
-
-
Handling Inter-Registrar Transfer Disputes
The transfer of a domain name from one Registrar to another is authorized by the Registrant/Admin Contact associated with the domain name through an approval link listed in the email sent by the
Gaining Registrar to the Registrant/Admin Contact email address. The approval may also be provided through offline methods such as fax, etc.
An unauthorized transfer can occur under the following circumstances:
-
It is possible that at the Losing Registrar, the domain management account of the domain name owner or email address of the Registrant/Admin Contact got compromised, whereby the alleged hacker was able to login to the account, modify the Registrant and/or Admin Contact details prior to transfer and approve the transfer using the transfer approval mail sent to the Registrant/Admin Contact.
-
It may also happen that the hacker got control of the domain name at Registrar A, initially transferred it to Registrar B and then under your Registrar account. Such cases might involve multiple intermediate Registrars.
In order to handle disputes arising out of such Inter-Registrar transfers, ICANN has formulated the Transfer Dispute Resolution Policy (TDRP). Under this Policy, the Losing Registrar may file a TDRP case with a Dispute Resolution Provider designated by ICANN. However, Registrars are advised to resort to a TDRP case only under extreme circumstances, when all attempts to have the dispute resolved amicably between the Registrars involved fail. This is because -
-
ICANN encourages Registrars to first try and resolve the dispute among the Registrars involved.
-
a TDRP case involves substantial fees.
-
it is a time-consuming process involving administrative proceedings.
Based on our experience regarding disputed transfers, we have developed a Transfer Undo process which is simple and easily adoptable by the Registrars and the Losing Registrant involved.
When the Losing Registrar contacts you regarding the transfer of a domain name from their Registrar account to you, then as per the ICANN's Transfer Policy, you need to provide the Losing Registrar details about the Form Of Authorization (FOA) that you had obtained from the Registrant/Admin Contact of the domain name related to the transfer of the domain name under your Registrar Account. See details
In case the transfer was approved by the Registrant/Admin Contact via fax or any other offline method, you need store a copy of such approval and present it to the Losing Registrar, if requested.
It is advised that at this stage, you lock the domain name and disable privacy protection (if enabled) with an appropriate reason.
The Losing Registrar may claim that the Registrant/Admin Contact's email (account) address and /or their customer's domain management account was hacked and that might have led to the transfer of the domain name under your Registrar account. It is important to note that even in such cases, the transfer happened as per the ICANN's Transfer Policy since the Registrant/Admin Contact clicked on the transfer approval link contained in the email sent by you (the Gaining Registrar) to the Registrant/Admin Contact email address as obtained from the Losing Registrar's Whois Server. Hence, in order to return the domain name back to the Losing Registrar with their customer (the Losing Registrant) as the Registrant, it is advised that you obtain an assurance from both Losing Registrar as well as the Losing Registrant about the order of events that took place leading to the transfer away of the said domain name to you. Our Transfer Undo process which may be adopted in such cases is described below.
Transfer Undo Process
-
Provide the Losing Registrar with 2 forms - (Losing) Registrar Transfer Undo Request Form as well as (Losing) Registrant Transfer Undo Request Form.
The (Losing) Registrant Transfer Undo Request Form requires the Registrant to submit a Notarized Affidavit in a certain format to the Losing Registrant, confirming that he was the Owner of the domain name prior to its transfer to you (the Gaining Registrar) and he did not wish to have the domain name Transferred from the Losing Registrar to you (the Gaining Registrar). The Affidavit needs to be Notarized from a Notary office of the local Court of Law.
-
The Losing Registrant sends these documents (Notarized Affidavit & Identification Proof) to the Losing Registrar for verification.
-
The Losing Registrar in turn completes the (Losing) Registrar Transfer Undo Request Form and forwards the following to you (the Gaining Registrar):
-
Losing Registrant's Notarized Affidavit
-
Losing Registrant's Identification Proof
-
completed (Losing) Registrar Transfer Undo Request Form
-
-
Once you verify all of the above documents, you would unlock the domain name, move it under your Compliance account and facilitate the transfer away of this name to the Losing Registrant under the Losing Registrar Account.
-
Transfer Undo Request Form Documents:
-
If there is a Transfer Secret/Authorization Code associated the domain name, you may modify the same and provide the new Transfer Secret/Authorization Code to the Losing Registrar for initiating the transfer to them. This is from a security perspective. See details
In case the Losing Registrar is not willing to follow the above Transfer Undo process, you may update them to advise their customer to reclaim the domain name via any of the below mentioned means:
-
If the Losing Registrar's customer has a Service Mark like a Trademark registered for the domain name, then their customer may file a Uniform Dispute Resolution Policy (UDRP) case for the same with an ICANN-approved
UDRP Service Provider.Additional Information -
In the absence of a Service Mark, the Losing Registrar's customer can complain to their City/State's Police Cyber Crime Department and provide them the required details, so that they initiate their investigations. The Police would then assist the customer in filing a case and bringing the matter for hearing in the Local Judicial Court. Once a judgment is delivered, the Losing Registrar's customer need to provide you a copy of the same so that you can abide by it.
The Transfer Undo Request Form Documents can also be used to re-gain domain names that have been transferred away from your Registrar Account, if the Gaining Registrar is willing to adopt the above Transfer undo process.
Resending .UK Transfer Notification to the Registrant
The process of transferring a .UK domain name from another Registrar is slightly different compared to the process for domain names under other extensions. In case of a .UK domain name, the Transfer In needs to be initiated at the Current Registrar's end.
As per the Transfer process, a mail is sent by the system to the Registrant Contact email address once the Transfer has been processed successfully by the .UK Registry. This email will be sent with your Registrar Branding details.
In case the Registrant does not receive this email or has misplaced it, it can be resent from within your Registrar/Reseller Control Panel, by following the below mentioned process:
-
Login to your Control Panel. See details
-
In the Menu, point to Products -> Domain Registration and click .UK Transfer-In Notifications.
-
Select the check box adjacent to the domain name's Security Key, for which you wish to resend the notification.
-
Click the Resend Mail button on the bottom of the page.
Manually Approving/Disapproving Domain Name Transfers
There are occasions, when the Admin Contact for a Domain Name does not receive a Form of Authorization (FOA) email from the system, to confirm their domain name Transfer.
-
Reasons for non-receipt of Form of Authorization email could be due to network/routing issues arising from E-mail block filters, accidental E-mail deletion, etc.
-
The Form of Authorization (FOA) email is also referred as Request for Approval (RFA) email, or more commonly as a Transfer Authorization email.
In cases where your Customer does not receive a Transfer In authorization email at the Administrative Contact's email address, he/she can still confirm their domain name Transfer, by either Resending the Transfer Authorization email or by using the Transfer FAX Form. See details
Upon receipt of such a FAX, the Transfer request would need to be manually processed by your Support Team.
To Approve a Transfer
-
Login to your Control Panel. See details
-
In the Menu, point to Products -> Domain Registration -> Pending Transfers and click Manual Approval.
-
-
To Approve a Transfer In:
-
Select Transfer In as the RFA Type.
NoteYou may search for the domain name, by mentioning the domain name in the Description textbox, toggling the list of TLDs in the Service dropdown and clicking the Search button.
-
Select the check box besides the Order Id that you want to approve and click the Confirm button on the top of the page.
Note-
Ensure that the RFA that you are going to confirm, has the Action Status as RFASent. This Action Status indicates that the system has already fetched the Contact details of the domain name from the Current Registrar's Whois server and has emailed the FOA to the current Administrative Contact.
-
It is imperitive that you use this method to approve a Transfer In, only in the case when you have received express authorization from the domain name(s) Owner in the form of the Transfer FAX Form
-
You can approve multiple Transfers by selecting the check box besides the relevant Order Ids and clicking the Confirm button. You can also approve Transfer of all the domain names listed on this page by selecting the check box besides the Order Id column heading and clicking the Confirm button.
-
-
-
To Approve a Transfer Away:
-
Select Transfer Away from us as the RFA Type.
NoteYou may search for the domain name, by mentioning the domain name in the Description textbox, toggling the list of TLDs in the Service dropdown and clicking the Search button.
-
Select the check box besides the Order Id that you want to approve and click the Confirm button on the top of the page.
Note-
Ensure that the RFA that you are going to confirm, has the Action Status as RFASent.
-
It is recommended that you approve a Transfer Away in this fashion, only when you have ascertained that the domain name Owner has authorised the Transfer Away to the Gaining Registrar.
-
You can approve multiple Transfers by selecting the check box besides the relevant Order Ids and clicking the Confirm button. You can also approve Transfer of all the domain names listed on this page by selecting the check box besides the Order Id column heading and clicking the Confirm button.
-
-
-
To Disapprove a Transfer
-
Login to your Control Panel. See details
-
In the Menu, point to Products -> Domain Registration -> Pending Transfers and click Manual Approval.
-
-
To Disapprove a Transfer In:
-
Select Transfer In as the RFA Type.
NoteYou may search for the domain name, by mentioning the domain name in the Description textbox, toggling the list of TLDs in the Service dropdown and clicking the Search button.
-
Select the check box besides the Order Id that you want to disapprove and click the Cancel button on the top of the page.
You can disapprove multiple Transfers by selecting the check box besides the relevant Order Ids and clicking the Cancel button. You can also disapprove Transfer of all the domain names listed on this page by selecting the check box besides the Order Id column heading and clicking the Cancel button.
-
-
To Disapprove a Transfer Away:
-
Select Transfer Away from us as the RFA Type.
NoteYou may search for the domain name, by mentioning the domain name in the Description textbox, toggling the list of TLDs in the Service dropdown and clicking the Search button.
-
Select the check box besides the Order Id that you want to disapprove and click the Cancel button on the top of the page.
You can disapprove multiple Transfers by selecting the check box besides the relevant Order Ids and clicking the Cancel button. You can also disapprove Transfer of all the domain names listed on this page by selecting the check box besides the Order Id column heading and clicking the Cancel button.
NoteA Transfer Away should be cancelled only under certain extinuating circumstances specified by ICANN..
Additional InformationCircumstances under which the Registrar of Record may deny a Transfer request
-
-