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

The following checks whether the domain name unusualTVname.tv is available and sends the response in XML format:
Query
https://resellertest.enom.com/interface.asp?
command=check&sld=unusualTVname&tld=tv&uid=resellid&pw=resellpw
&responsetype=xml
The response indicates that unusualTVname.tv is available and that it is a Premium name in Early Access Phase (EAP):
Output
<interface-response>
<DomainName>unusualtvname.tv</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>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable>True</IsLockable>
<IsRealTimeTLD>True</IsRealTimeTLD>
<TimeDifference>+08.00</TimeDifference>
<ExecTime>0.235</ExecTime>
<Done>true</Done>
<RequestDateTime>12/7/2011 4:11:54 AM</RequestDateTime>
<debug></debug>
</interface-response>

The following checks whether the domain name unusualTVname.tv is available and sends the response in HTML format:
Query
https://resellertest.enom.com/interface.asp?
command=check&sld=unusualTVname&tld=tv&uid=resellid&pw=resellpw
&responsetype=html
The response indicates that unusualTVname.tv is available:
Output
;URL Interface
;Machine is SJL0VWRESELL_T1
;Encoding Type is utf-8
DomainName: unusualtvname.tv
IsEAP: true
IsPremiumName: true
PremiumPrice: 11022.00
ExpectedCustomerSuppliedPrice: 11022.00
RegistrationFee: 22.00
EAPFee: 11000.00
RenewalPrice: 22.00
RestorePrice: 250.00
TransferPrice: 22.00
RRPCode: 210
RRPText: Domain available
Command: CHECK
APIType: API.NET
Language: eng
ErrCount: 0
ResponseCount: 0
MinPeriod: 1
MaxPeriod: 10
Server: sjl0vwresell_t1
Site: eNom
IsLockable: True
IsRealTimeTLD: True
TimeDifference: +8.00
ExecTime: 0.719
Done: true
TrackingKey: e77da639-353b-47d5-9c5b-8c8853d3d4af
RequestDateTime: 2/3/2015 2:34:59 PM

The following checks whether the domain name unusualTVname.tv is available and sends the response in Text format:
Query
https://resellertest.enom.com/interface.asp?
command=check&sld=unusualTVname&tld=tv&uid=resellid&pw=resellpw
&responsetype=text
The response indicates that unusualTVname.tv is available:
Output
;URL Interface
;Machine is SJL0VWRESELL_T1
;Encoding Type is utf-8
DomainName=unusualtvname.tv
IsEAP=true
IsPremiumName=true
PremiumPrice=11022.00
ExpectedCustomerSuppliedPrice=11022.00
RegistrationFee=22.00
EAPFee=11000.00
RenewalPrice=22.00
RestorePrice=250.00
TransferPrice=22.00
RRPCode=210
RRPText=Domain available
Command=CHECK
APIType=API.NET
Language=eng
ErrCount=0
ResponseCount=0
MinPeriod=1
MaxPeriod=10
Server=sjl0vwresell_t1
Site=eNom
IsLockable=True
IsRealTimeTLD=True
TimeDifference=+8.00
ExecTime=0.719
Done=true
TrackingKey=e77da639-353b-47d5-9c5b-8c8853d3d4af
RequestDateTime=2/3/2015 2:34:59 PM