GetExpiredDomains

Retrieve a list of an account’s domains that are in Expired, Redemption Grace Period (RGP), and Extended RGP status.

Usage

Use this command to retrieve a list of Expired, RGP, and Extended RGP names in the account specified in the query string. Typically, a reseller will use this information to determine which command to use to reactivate a domain, and what price they will charge.

Availability

All resellers have access to this command.

Constraints

The query must meet the following requirements:

  • The AuthQuestionAnswer value must be correct.

Input Parameters

https://resellertest.enom.com/interface.asp?command=GetExpiredDomains&uid=(Required)&PW=(Required)&responsetype=(Optional)
Input ParameterTypeStatusDescription
commandstringRequiredGetExpiredDomains
UIDstringRequiredYour Account ID
PWstringRequiredLogin ID for the account for which you want the password.
ResponseTypestringOptionalFormat of response. Permitted values are
Text (default)
HTML
* XML

Returned Parameters and Values

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, the process returns parameters as defined below.

Output ParameterTypeDescription
CommandstringName of command executed
DomainNamestringDomain name
DomainNameIDstringDomain name ID number, from our database
StatusstringExpiration status of this domain
Expiration-DatestringExpiration date of this domain
LockStatusstringRegistrar lock status of this domain
ErrCountintThe number of errors if any occurred. If greater than 0 check the Err(1 to ErrCount) values.
ErrXstringError messages explaining the failure. These can be presented as is back to the client.
Doneboolian"True" indicates this entire response has reached you successfully.

Example Output

The following query requests the account balance for account Login Id "resellid". The query also requests the response in XML, HTML, or Text format.

https://resellertest.enom.com/interface.asp?
command=getexpireddomains&uid=resellid
&pw=resellpw&responsetype=xml
https://resellertest.enom.com/interface.asp?
command=getexpireddomains&uid=resellid
&pw=resellpw&ResponseType=html
https://resellertest.enom.com/interface.asp?
command=getexpireddomains&uid=resellid
&pw=resellpw&ResponseType=text
<?xml version="1.0" ?>
<interface-response>
 <DomainDetail>
  <DomainName>northwestcrafts.com</DomainName>
  <DomainNameID>152139242</DomainNameID>
  <status>Extended RGP</status>
  <expiration-date>2/26/2003</expiration-date>
  <lockstatus>Locked</lockstatus>
 </DomainDetail>
 <DomainDetail>
  <DomainName>fabrics-wallpaper.com</DomainName>
  <DomainNameID>152134074</DomainNameID>
  <status>RGP</status>
  <expiration-date>3/1/2003 6:54:40 AM</expiration-date>
  <lockstatus>Locked</lockstatus>
 </DomainDetail>
 <DomainDetail>
  <DomainName>onlinebrochure.com</DomainName>
  <DomainNameID>152129772</DomainNameID>
  <status>RGP</status>
  <expiration-date>6/4/2002 6:18:36 PM</expiration-date>
  <lockstatus>Locked</lockstatus>
 </DomainDetail>
 <DomainDetail>
  <DomainName>eweathervane.com</DomainName>
  <DomainNameID>2062920</DomainNameID>
  <status>Expired</status>
  <expiration-date>3/8/2002 2:14:45 AM</expiration-date>
  <lockstatus>Locked</lockstatus>
 </DomainDetail>
 <DomainDetail>
  <DomainName>signonworldwide.com</DomainName>
  <DomainNameID>2063248</DomainNameID>
  <status>Expired</status>
  <expiration-date>3/8/2011 11:38:32 PM</expiration-date>
  <lockstatus>Locked</lockstatus>
 </DomainDetail>
 <DomainDetail>
  <DomainName>Youcanhelp.net</DomainName>
  <DomainNameID>152151738</DomainNameID>
  <status>Expired</status>
  <expiration-date>3/7/2011 6:44:29 PM</expiration-date>
  <lockstatus>Locked</lockstatus>
 </DomainDetail>
 <DomainDetail>
  <DomainName>ccpays.com</DomainName>
  <DomainNameID>2082140</DomainNameID>
  <status>Extended RGP</status>
  <expiration-date>2/26/2011 4:01:46 PM</expiration-date>
  <lockstatus>Locked</lockstatus>
 </DomainDetail>
.
.
.
 <domaincount>120</domaincount>
 <Command>GETEXPIREDDOMAINS</Command>
 <Language>en</Language>
 <ErrCount>0</ErrCount>
 <ResponseCount>0</ResponseCount>
 <MinPeriod />
 <MaxPeriod>10</MaxPeriod>
 <Server>RESELLERTEST</Server>
 <Site>enom</Site>
 <IsLockable />
 <IsRealTimeTLD />
 <TimeDifference>+0.00</TimeDifference>
 <ExecTime>1.503906</ExecTime>
 <Done>true</Done>
 <debug>
  <![CDATA [ ] ]>
 </debug>
</interface-response>
;URL Interface<br>
;Machine is SJL0VWRESELL_T<br>
;Encoding Type is utf-8<br>
<HTML><BODY>
<STRONG>DomainName1: </ STRONG>00000000001111.com<br>
<STRONG>DomainNameID1: </ STRONG>340691704<br>
<STRONG>status1: </ STRONG>Expired<br>
<STRONG>expiration-date1: </ STRONG>7/7/2013 8:37:00 AM<br>
<STRONG>lockstatus1: </ STRONG>Locked<br>
<STRONG>DomainName2: </ STRONG>00000startajay.name<br>
<STRONG>DomainNameID2: </ STRONG>152708848<br>
<STRONG>status2: </ STRONG>Expired<br>
<STRONG>expiration-date2: </ STRONG>2/4/2009 6:25:00 AM<br>
<STRONG>lockstatus2: </ STRONG>Not Locked<br>
<STRONG>DomainName3: </ STRONG>00000startajay.net<br>
<STRONG>DomainNameID3: </ STRONG>152708843<br>
<STRONG>status3: </ STRONG>Expired<br>
<STRONG>expiration-date3: </ STRONG>2/4/2009 6:25:00 AM<br>
<STRONG>lockstatus3: </ STRONG>Locked<br>
<STRONG>DomainName4: </ STRONG>00000startajay.tv<br>
<STRONG>DomainNameID4: </ STRONG>152708844<br>
<STRONG>status4: </ STRONG>Expired<br>
<STRONG>expiration-date4: </ STRONG>2/4/2009 6:25:00 AM<br>
<STRONG>lockstatus4: </ STRONG>Locked<br>
<STRONG>DomainName5: </ STRONG>0000ragavan.com<br>
<STRONG>DomainNameID5: </ STRONG>322157180<br>
<STRONG>status5: </ STRONG>Expired<br>
<STRONG>expiration-date5: </ STRONG>2/19/2009 7:06:26 AM<br>
<STRONG>lockstatus5: </ STRONG>Locked<br>
<STRONG>DomainName6: </ STRONG>000ajaycouk.com<br>
<STRONG>DomainNameID6: </ STRONG>152708718<br>
<STRONG>status6: </ STRONG>Expired<br>
<STRONG>expiration-date6: </ STRONG>1/30/2009 7:05:00 AM<br>
<STRONG>lockstatus6: </ STRONG>Locked<br>
.
.
.
<STRONG>domaincount: </ STRONG>7606<br>
<STRONG>Command: </ STRONG>GETEXPIREDDOMAINS<br>
<STRONG>APIType: </ STRONG>API.NET<br>
<STRONG>Language: </ STRONG>eng<br>
<STRONG>ErrCount: </ STRONG>0<br>
<STRONG>ResponseCount: </ STRONG>0<br>
<STRONG>MinPeriod: </ STRONG>1<br>
<STRONG>MaxPeriod: </ STRONG>10<br>
<STRONG>Server: </ STRONG>sjl0vwresell_t1<br>
<STRONG>Site: </ STRONG>eNom<br>
<STRONG>IsLockable:</ STRONG><br>
<STRONG>IsRealTimeTLD:</ STRONG><br>
<STRONG>TimeDifference: </ STRONG>+0.00<br>
<STRONG>ExecTime: </ STRONG>0.469<br>
<STRONG>Done: </ STRONG>true<br>
<STRONG>TrackingKey: </ STRONG>ef1c62d8-12ba-4dde-9482-dc5c0ce526ab<br>
<STRONG>RequestDateTime: </ STRONG>2/3/2015 6:14:12 PM<br>
</BODY></HTML>
;URL Interface
;Machine is SJL0VWRESELL_T
;Encoding Type is utf-8
DomainName1=00000000001111.com
DomainNameID1=340691704
status1=Expired
expiration-date1=7/7/2013 8:37:00 AM
lockstatus1=Locked
DomainName2=00000startajay.name
DomainNameID2=152708848
status2=Expired
expiration-date2=2/4/2009 6:25:00 AM
lockstatus2=Not Locked
DomainName3=00000startajay.net
DomainNameID3=152708843
status3=Expired
expiration-date3=2/4/2009 6:25:00 AM
lockstatus3=Locked
DomainName4=00000startajay.tv
DomainNameID4=152708844
status4=Expired
expiration-date4=2/4/2009 6:25:00 AM
lockstatus4=Locked
DomainName5=0000ragavan.com
DomainNameID5=322157180
status5=Expired
expiration-date5=2/19/2009 7:06:26 AM
lockstatus5=Locked
DomainName6=000ajaycouk.com
DomainNameID6=152708718
status6=Expired
expiration-date6=1/30/2009 7:05:00 AM
lockstatus6=Locked
.
.
.
domaincount=7606
Command=GETEXPIREDDOMAINS
APIType=API.NET
Language=eng
ErrCount=0
ResponseCount=0
MinPeriod=1
MaxPeriod=10
Server=sjl0vwresell_t
Site=eNom
IsLockable=
IsRealTimeTLD=
TimeDifference=+0.00
ExecTime=0.266
Done=true
TrackingKey=e12a3134-f988-4513-9009-57b989345db6
RequestDateTime=2/3/2015 6:15:06 PM

Related Commands

AddToCart
Extend_RGP
GetDomainInfo
GetDomains
PE_SetPricing
Purchase