RPT_GetReport
Retrieve an itemized list of one type of activity in a domain name account.
Usage
Use this command to retrieve a list of one of the following types of account activity in a domain name account: registrations, renewals, transfers, private label, sub-accounts, accounting, or expiring names.
Availability
All resellers have access to this command.
Constraints
The query must meet the following requirements:
- The login ID and password must be valid.
- The beginning date for reports must be no earlier than 6 months before today.
- The "ResponseType" must be XML. You can parse the XML response after receiving it.
Input Parameters
https://resellertest.enom.com/interface.asp?command=RPT_GETREPORT&uid=(Required)&pw=(Required)&ReportType=(Required)&BeginDate=(Optional)&EndDate=(Optional)&Download=(Required)&responsetype=xmlInput Parameter | Type | Status | Description |
|---|---|---|---|
command | string | Required | RPT_GetReport |
uid | string | Required | Your Account ID |
pw | string | Required | Your API Token |
Version | string | Optional; default is 0 | Version of this command. Permitted values are 0 and 1. Use "Version=1" to receive the return parameters listed in the Returned parameters table below. "Version=0" and "Version=1" return parameters vary slightly in the data returned and in the tag names. We recommend that you use "Version=1",which avoids timeouts by supporting paging of results, and queuing of the query. |
ReportType | boolean | Required | Type of report to generate. Permitted values are: |
BeginDate | boolean | Optional; default is the last day of the month, two months before the current month | First date to include in the report. Must be no earlier than six months before today. Use format MM/DD/YYYY |
EndDate | string | Optional; default is today’s date | Last date to include in the report. Use format MM/DD/YYYY |
Start | string | Optional; default is 1 | In the overall list of returns for this report type and date range, the start position for the return to this query. |
RecordsToReturn | int | Optional; default is 100 if Download=False | Number of items to return in this report. |
Download | boolean | Required | Do you wish to run report in real time or deliver to this account’s Billing contact email address? Permitted values are: Reports will always be delivered by email if they extend past four months before today, or if they include more than 25,000 results. |
ReportOutputType | string | Required, if "Download=True" | If delivering the report via email, "ReportOutputType" must be 2. |
ResponseType | string | Required | Format of response. Permitted value is "XML". |
Returned Parameters and Values
The default response format is XML.
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 |
|---|---|---|
RptString | string | List report descriptions |
ThreeMoPast | string | The date three months before today |
SixMoPast | string | The date six months before today |
BeginDate | string | The first date included in this report |
EndDate | string | The last date included in this report |
ID | int | Report type identification number |
Name | string | Report name |
ReportType | string | Report type specified in this query string |
ReportName | string | Name of the report type specified in this query string |
QueueReportResults | int | Should report results be queued. |
ReportResults | string | Results specific to this report type. The results, and return parameters, vary by report type. |
DomainName | string | Domain name |
OrderID | int | Order identification number |
Commission | float | Commission |
SalePrice | float | Sale price |
DateApplied | string | Date sale was recorded |
LoginID | string | Login ID to which this order was delivered |
NewStartPosition | string | In the full list of results, the start position of the next page of results |
ThisStartPosition | string | In the full list of results, the position of the first result listed on this page |
ThisEndPosition | string | In the full list of results, the position of the last result listed on this page |
PreviousStartPosition | string | In the full list of results, the position of the previous page of results |
TotalReturned | int | Number of results listed on this page |
TotalRows | int | Number of results total for this report |
ShowPrevious | string | Should this page show a link to the previous page of results? |
ShowNext | string | Should this page show a link to the next page of results? |
ShowPaging | string | Should this page show links to previous and next results? |
Version | float | Version of this command that generated this return |
Command | string | Name of command executed |
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 a list of registrations for the period 12/1/2009 to 1/1/2010, and sends the response in XML format.
https://resellertest.enom.com/interface.asp?command=RPT_GETREPORT&uid=resellid&pw=resellpw&ReportType=0&BeginDate=12/01/2010&EndDate=01/01/2011&responsetype=xml<interface-response>
<rpt>
<rptString>Registrations | Renewals | Transfers In | Private Label |
Sub-Accounts | Accounting | Expiring Domains | | | | Pricing Editor Updates |
Transfers Out | | Business Listing Bulk Update | | Business Listing
Domain Update | Transactions | Order History | Periodic Billing History | |
Premium Registration | Monthly Invoices | Invoice History | Invoice Detail |
List of Invoices | Top Watchlist TLDs | Watchlist Summary | Top Watchlists |
All Watchlists | All Watchlist Details | Domain Name History |
Domain Verification/Suspension
</rptString>
<threemopast>9/12/2011</threemopast>
<sixmopast>6/12/2011</sixmopast>
<begindate>12/6/2011</begindate>
<enddate>12/12/2011</enddate>
<option>
<reporttype id="0" name="Registrations"></reporttype>
<reporttype id="1" name="Renewals"></reporttype>
<reporttype id="2" name="Transfers In"></reporttype>
<reporttype id="11" name="Transfers Out"></reporttype>
<reporttype id="3" name="Private Label"></reporttype>
<reporttype id="4" name="Sub-Accounts"></reporttype>
<reporttype id="5" name="Accounting"></reporttype>
<reporttype id="6" name="Expiring Domains"></reporttype>
<reporttype id="10" name="Pricing Editor Updates"></reporttype>
<reporttype id="13" name="Business Listing Bulk Update"></reporttype>
<reporttype id="15" name="Business Listing Domain Update"></reporttype>
<reporttype id="16" name="Transactions"></reporttype>
<reporttype id="17" name="Order History"></reporttype>
<reporttype id="18" name="Periodic Billing History"></reporttype>
<reporttype id="20" name="Premium Registration"></reporttype>
<reporttype id="21" name="Monthly Invoices"></reporttype>
<reporttype id="22" name="Invoice History"></reporttype>
<reporttype id="23" name="Invoice Detail"></reporttype>
<reporttype id="24" name="List of Invoices"></reporttype>
<reporttype id="25" name="Top Watchlist TLDs"></reporttype>
<reporttype id="26" name="Watchlist Summary"></reporttype>
<reporttype id="27" name="Top Watchlists"></reporttype>
<reporttype id="28" name="All Watchlists"></reporttype>
<reporttype id="29" name="All Watchlist Details"></reporttype>
<reporttype id="30" name="Domain Name History"></reporttype>
<reporttype id="31" name="Domain Verification/Suspension"></reporttype>
</option>
<reporttype>0</reporttype>
<reportname> Registrations </reportname>
<results>
<rpttld>
<report0-single tld="com" sum="2"/>
<report0-single tld="net" sum="1"/>
</rpttld>
<rptrawxml>
<row OrderID="157781016" SLD="resellerdocs1"
TLD="com" CreationDate="2011-12-09T03:25:03.253"
ExpDate="2012-12-09T11:25:00" PaidAmount="8.9500"
BilledToCust="0.0000"/>
<row OrderID="157781016" SLD="resellerdocs123"
TLD="com" CreationDate="2011-12-09T03:25:06.657"
ExpDate="2012-12-09T11:25:00" PaidAmount="8.9500"
BilledToCust="0.0000"/>
<row OrderID="157781021" SLD="resellerdocs12312"
TLD="net" CreationDate="2011-12-09T03:58:41.283"
ExpDate="2012-12-09T03:58:00" PaidAmount="8.9500"
BilledToCust="0.0000"/>
</rptrawxml>
<NewThisMonth>3</NewThisMonth>
<AverageRegPeriod>1.000000</AverageRegPeriod>
</results>
</rpt>
<Command>RPT_GETREPORT</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod/>
<MaxPeriod>10</MaxPeriod>
<Server>SJL21WRESELLT01</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.422</ExecTime>
<Done>true</Done>
<RequestDateTime>1/6/2014 4:16:19 AM</RequestDateTime>
<debug></debug>
</interface-response>Related Commands
CreateAccount
CreateSubAccount
GetAccountInfo
GetAccountPassword
GetAllAccountInfo
GetOrderDetail
GetOrderList
GetReport
GetSubAccounts
GetTransHistory
