Check Availability - IDN

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.

  • .EU IDN: You can refer to supported character sets here.

  • .IN.NET IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets here.

  • .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:

  • .PW IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets here.

  • CentralNic IDN: The character set depends upon the language chosen for the Internationalized Domain Name. You can refer to supported character sets below:

  • .在线 (Chinese IDN for .online): You can refer to supported character set here.

  • .中文网 (Chinese IDN for .network): You can refer to supported character set here.

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:

  • .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

  • .EU IDN: The language code needs to be mentioned as latin.

    idnLanguageCode=latin

  • .IN.NET IDN: The language code depends upon the language whose characters are used in the domain name. Supported languages and the corresponding language codes are:

    • Arabic - ara

    • Chinese - chi

    • Cyrillic - cyr

    • Greek - gre

    • Hebrew - heb

    • Japanese - jpn

    • Korean - kor

    • Lao - lao

    • Latin - lat

    • Thai - tha

    idnLanguageCode=jpn

  • .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

  • .PW IDN: The language code depends upon the language whose characters are used in the domain name. Supported languages and the corresponding language codes are:

    • Arabic - ara

    • Chinese - chi

    • Cyrillic - cyr

    • Greek - gre

    • Hebrew - heb

    • Japanese - jpn

    • Korean - kor

    • Lao - lao

    • Latin - lat

    • Thai - tha

    idnLanguageCode=tha

  • CentralNic IDN: The language code depends upon the language whose characters are used in the domain name. Supported languages and the corresponding language codes are:

    • .EU.COM:

      • Arabic - ara

      • Cyrillic - cyr

      • Greek - gre

      • Hebrew - heb

      • Latin - lat

    • .GB.COM, .QC.COM, .DE.COM, .GB.NET, .NO.COM, .HU.COM, .UY.COM, .ZA.COM, .BR.COM, .SE.COM, .SE.NET, .UK.COM and .UK.NET:

      • Latin - lat

    • .AE.ORG and .SA.COM:

      • Arabic - ara

    • .KR.COM:

      • Korean - kor

    • .US.COM:

      • Arabic - ara

      • Chinese - chi

      • Cyrillic - cyr

      • Greek - gre

      • Hebrew - heb

      • Japanese - jpn

      • Latin - lat

    • .GR.COM:

      • Greek - gre

    • .JPN.COM:

      • Japanese - jpn

    • .CN.COM:

      • Chinese - chi

    • .RU.COM:

      • Cyrillic - cyr

    idnLanguageCode=lat

  • .在线 (Chinese IDN for .online): The language code needs to be mentioned as zh.

    attr-name1=idnLanguageCode&attr-value1=zh

  • .中文网 (Chinese IDN for .network): The language code needs to be mentioned as zh.

    attr-name1=idnLanguageCode&attr-value1=zh

  • .भारत (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. 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.