Check


Definition

Check the availability of a domain name.

Usage

Use this command to check whether a domain name is already registered.

Availability

The Check command is available to every reseller.

Implementation on eNom.com

http://www.enom.com/

When you type a domain name in the Register A Domain boxes, the GO or Search buttons call the Check command.

Constraints

Domain names must meet the following requirements:

  • Second-level domain (SLD) must be composed of the letters a through z, the numbers 0 through 9, and the hyphen (-) character.
  • Some foreign character sets can display onscreen, but resolve to alphanumeric plus hyphen characters in the underlying code.
  • The SLD must not begin or end with the hyphen character.
  • The SLD must not contain spaces.
  • The SLD must not contain special characters other than the hyphen character.
  • The third and fourth characters of the SLD must not both be hyphens unless it is an encoded international-character domain name.
  • The SLD must contain 2 to 63 characters, inclusive.
  • SLDs are not case sensitive.
  • The SLD-TLD combination must be unique.

Input parameters

Build the query string using this syntax:

https://resellertest.enom.com/interface.asp?
Command=Check&UID=YourLogin&PW=YourPassword
&SLD=DesiredSLD&TLD=DesiredTLD&OptParam1=ParamValue1
&OptParam2=ParamValue2

 

Parameter Status Description Max Size
UID Required Account login ID 20
PW Required Account password 20
SLD Required unless DomainList is used Second-level domain name (for example, enom in enom.com) 63
TLD Required unless DomainList or TLDList is used Top-level domain name (extension). Permitted values: Any single TLD, for example, com * returns 11 of the most commonly used TLDs:com, org, net, biz, ws, info, cc, us, tv, bz, nu *1 returns com, net, org, info, biz, us, ws *2 returns com, net, org, info, biz, us @ returns com, net, org 15
DomainList Optional A comma- or newline-delimited list of domains to check, up to 30 names. If used, SLD and TLD are ignored. 2000
TLDList Optional A comma- or newline-delimited list of TLDs to check, up to 30 names. If used, TLD is ignored. 2000
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML. 4

 

Returned parameters and values

Parameter Description
DomainX If return includes multiple domains, the name of domain X (indexed X in HTML and Text output, but not in XML output)
RRPCodeX Success code. Only 210 indicates that the name is available at the Registry. 211 indicates the domain is not available at the Registry.
RRPTextX Text which accompanies and describes the RRPCode. 210 Domain available 211 Domain not available
IsPremiumName True indicates this is a premium name.
PremiumPrice Registration price per year for this premium name, in $US.
PremiumAboveThresholdPrice True indicates the registration price for this premium name is higher than for non-premium names.
DomainCount The number of names checked.
Command Name of command executed
ErrCount The number of errors if any occurred. If greater than 0 check the Err(1 to ErrCount) values.
ErrX Error messages explaining the failure. These can be presented as is back to the client.
Done True indicates this entire response has reached you successfully.

 

Notes

  • The default response format is plain text. To receive the response in HTML or XML format, send ResponseType=HTML or ResponseType=XML in your request.
  • Check the return parameter ErrCount. If greater than 0 the transaction failed. The parameter Err(ErrCount) can be presented to the client. Otherwise process the returned parameters as defined above.
  • When parsing the response, use the RRPCode value rather than the RRPText value or the position in the response. Of these, only the RRPCode value is guaranteed by the Registry to be stable.
  • Pricing information will be returned if the domain name is a gTLD, if the name is Premium, if the TLD is in EAP, or any combination of these cases. Pricing will not be returned if the TLD is a legacy TLD in general availability.
  • .TV is used in the sample code below, but .TV is the only TLD that does not return pricing information in the <check> response.

If Domain is in EAP

The response will contain pricing information for Premium even if the domain name you are checking is not Premium, in addition to the EAP participation fee. eNom expects the registrar to provide the ExpectedCustomerSuppliedPrice to be sent to the purchase command to confirm the purchase price.

Response:

<DomainName>1.agency</DomainName>

<IsEAP>true</IsEAP>

<IsPremiumName>false</IsPremiumName>

<PremiumPrice>11000.00</PremiumPrice>

<ExpectedCustomerSuppliedPrice>11000.00</ExpectedCustomerSuppliedPrice>

<RegistrationFee>18.00</RegistrationFee>

<EAPFee>11000.00</EAPFee>

<RenewalPrice>18.00</RenewalPrice>

<RestorePrice>250.00</RestorePrice>

<TransferPrice>18.00</TransferPrice>

<RRPCode>210</RRPCode>

<RRPText>Domain available</RRPText>

<Command>CHECK</Command>

If Domain is EAP and Premium

eNom is returning all pricing information for a domain in the server response. If the domain is available and is both in EAP and a Premium name, eNom expects the registrar to provide the ExpectedCustomerSuppliedPrice to be sent to the purchase command to confirm agreement with the purchase price (including EAP participation fee and Premium name).

Response:

<DomainName>action.agency</DomainName>

<IsEAP>true</IsEAP>

<IsPremiumName>true</IsPremiumName>

<PremiumPrice>11022.00</PremiumPrice>

<ExpectedCustomerSuppliedPrice>11022.00</ExpectedCustomerSuppliedPrice>

<RegistrationFee>22.00</RegistrationFee>

<EAPFee>11000.00</EAPFee>

<RenewalPrice>22.00</RenewalPrice>

<RestorePrice>250.00</RestorePrice>

<TransferPrice>22.00</TransferPrice>

<RRPCode>210</RRPCode>

<RRPText>Domain available</RRPText>

<Command>CHECK</Command>

If Domain is Premium in GA

eNom is returning all pricing information for a domain in the server response. If the domain is a Premium name, eNom expects the registrar to provide the ExpectedCustomerSuppliedPrice to be sent to the purchase command to confirm agreement with the purchase price (including EAP participation fee and Premium name).

Response:

<DomainName>1plus1.tv</DomainName>

<IsPremiumName>true</IsPremiumName>

<PremiumPrice>999.00</PremiumPrice>

<RegistrationFee>999.00</RegistrationFee>

<RenewalPrice>110.00</RenewalPrice>

<RestorePrice>160.00</RestorePrice>

<TransferPrice>39.95</TransferPrice>

<RRPCode>210</RRPCode>

<RRPText>Domain available</RRPText>

<Command>CHECK</Command>

Example