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 Parameter | Type | Status | Description |
---|---|---|---|
command | string | Required | GetExpiredDomains |
UID | string | Required | Your Account ID |
PW | string | Required | Login ID for the account for which you want the password. |
ResponseType | string | Optional | Format 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 Parameter | Type | Description |
---|---|---|
Command | string | Name of command executed |
DomainName | string | Domain name |
DomainNameID | string | Domain name ID number, from our database |
Status | string | Expiration status of this domain |
Expiration-Date | string | Expiration date of this domain |
LockStatus | string | Registrar lock status of this domain |
ErrCount | int | The number of errors if any occurred. If greater than 0 check the Err(1 to ErrCount) values. |
ErrX | string | Error messages explaining the failure. These can be presented as is back to the client. |
Done | boolian | "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
Updated less than a minute ago