Description
Checks the availability of the specified Internationalized Domain Name(s) (IDN).
Parameters
| Name |
Data Type |
Required / Optional |
Description |
| auth-userid |
Integer |
Required |
Authentication Parameter |
| api-key or auth-password |
String |
Required |
Authentication Parameter |
| domain-name |
Array of Strings |
Required |
Internationalized Domain Name(s) that you need to check the availability for.
Refer to the supported character set mentioned below:
.COM / .NET IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets here.
Note
the character ς (codepoint=962) is not supported on our platform.
.NAME IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets here.
Note
the character ς (codepoint=962) is not supported on our platform.
-
.INFO IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets here.
-
.ORG IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets below:
-
.BIZ IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets below:
-
.TEL IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets below:
-
.ASIA IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets here.
-
.EU IDN: You can refer to supported character sets here.
.DE IDN: Restricted German characters, English alphabets and digits
Note
the character ß (codepoint=223) is not supported on our platform.
.ES IDN: Restricted Spanish characters, English alphabets and digits .CO IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets below:
.CA IDN: French characters, English alphabets and digits
|
| tld |
String |
Required |
TLD for which the domain name availability needs to be checked. |
| idnLanguageCode |
String |
Required |
While performing check availability for an Internationalized Domain Name, you need to provide the corresponding language code:
.COM / .NET IDN: The language code depends upon the language whose characters are used in the domain name. You can refer to the list of languages supported and the corresponding language code.
idnLanguageCode=aze
.NAME IDN: The language code depends upon the language whose characters are used in the domain name. You can refer to the list of languages supported and the corresponding language code.
attr-name1=idnLanguageCode&attr-value1=aze.INFO IDN: The language code depends upon the language whose characters are used in the domain name. Supported languages and the corresponding language codes are:
Danish - da German - de Hungarian - hu Icelandic - is Korean - ko Lithuanian - lt Latvian - lv Polish - pl Spanish - es Swedish - sw
idnLanguageCode=ko
.ORG IDN: The language code depends upon the language whose characters are used in the domain name. Supported languages and the corresponding language codes are:
Danish - da German - de Hungarian - hu Icelandic - is Korean - ko Lithuanian - lt Latvian - lv Polish - pl Spanish - es Swedish - sw Chinese - zh-cn
idnLanguageCode=ko
.BIZ IDN: The language code depends upon the language whose characters are used in the domain name. Supported languages and the corresponding language codes are:
Danish - da German - de Hungarian - hu Icelandic - is Korean - ko Lithuanian - lt Latvian - lv Polish - pl Spanish - es Swedish - sv Chinese - zh Finnish - fi Portuguese - pt Norwegian - no Japanese - jp
idnLanguageCode=ko
.TEL IDN: The language code depends upon the language whose characters are used in the domain name. Supported languages and the corresponding language codes are:
Danish - da German - de Hungarian - hu Icelandic - is Korean - ko Lithuanian - lt Latvian - lv Polish - pl Spanish - es Swedish - sv Chinese - zh Finnish - fi Portuguese - pt Norwegian - no Japanese - jp French - fr Russian - ru
idnLanguageCode=ko
.ASIA IDN: The language code depends upon the language whose characters are used in the domain name. Supported languages and the corresponding language codes are:
Korean - ko Chinese - zh Japanese - ja
idnLanguageCode=ko
.EU IDN: The language code needs to be mentioned as latin.
idnLanguageCode=latin.DE IDN: The language code needs to be mentioned as de.
idnLanguageCode=de.ES IDN: The language code needs to be mentioned as es.
idnLanguageCode=es.CO IDN: The language code depends upon the language whose characters are used in the domain name. Supported languages and the corresponding language codes are:
Danish - da Icelandic - is Spanish - es Swedish - sv Finnish - fi Norwegian - no Chinese - zh Japanese - jp Korean - ko
idnLanguageCode=da
.CA IDN: The language code needs to be mentioned as fr.
idnLanguageCode=fr
|
HTTP Method
GET
Example Test URL Request
https://test.httpapi.com/api/domains/idn-available.json?auth-userid=0&api-key=key&domain-name=ѯҋ111&domain-name=ѯҋ112&tld=com&idnLanguageCode=aze
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.
unknown - returned, if for some reason, the Registry connections are not available. You should ideally re-check the domain name availability after some time.