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 |
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 sets mentioned below:
-
.ASIA IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets here.
-
.BIZ IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets below:
.CO IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets 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.
-
.INFO IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets below:
.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.
-
.ORG 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:
Note
The domain name used in the API call can be in Unicode (the native language) or in Punycode format.
Example: The domain name can be provided as ѯҋ111 (Unicode) or xn--111-dkd4l (Punycode).
domain-name=ѯҋ111
domain-name=xn--111-dkd4l
|
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:
.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:
Chinese - zh
Japanese - ja
Korean - ko
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:
Chinese - zh
Danish - da
Finnish - fi
German - de
Hungarian - hu
Icelandic - is
Japanese - jp
Korean - ko
Lithuanian - lt
Latvian - lv
Norwegian - no
Polish - pl
Portuguese - pt
Spanish - es
Swedish - sv
idnLanguageCode=ko
.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:
Chinese - zh
Danish - da
Finnish - fi
Icelandic - is
Japanese - jp
Korean - ko
Norwegian - no
Spanish - es
Swedish - sv
idnLanguageCode=da
.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
.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 - sv
idnLanguageCode=ko
.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.
idnLanguageCode=aze
.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:
Chinese - zh-cn (for IDN.org domain name and .机构 domain name - the Chinese IDN for .org)
Cyrillic - ru (for .орг domain name - the Russian IDN for .org)
Danish - da
German - de
Hindi - hin-deva (for .संगठन domain name - the Hindi IDN for .org)
Hungarian - hu
Icelandic - is
Korean - ko
Latvian - lv
Lithuanian - lt
Polish - pl
Spanish - es
Swedish - sv
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:
Chinese - zh
Danish - da
Finnish - fi
French - fr
German - de
Hungarian - hu
Icelandic - is
Japanese - jp
Korean - ko
Latvian - lv
Lithuanian - lt
Norwegian - no
Polish - pl
Portuguese - pt
Russian - ru
Spanish - es
Swedish - sv
idnLanguageCode=ko
.भारत (Hindi IDN for .BHARAT): The language code needs to be mentioned as hin-deva.
attr-name1=idnLanguageCode&attr-value1=hin-deva
|
HTTP Method
GET
Example Test URL Request
https://domaincheck.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.