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:
-
.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 See details |
idnLanguageCode |
String |
Required |
While performing check availability for an Internationalized Domain Name, you need to provide the corresponding language code:
-
.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
|
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. 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.