The Reports Edesk API lets you request reports. Report types are specified using the ReportType enumeration.

The report process begins by creating a report request. Next, you obtain a list of report requests which shows the report request identifier and status of each requested report. Finally, you use the report request identifier from this listing to get the actual report. The process steps are as follows:

Submit a report request using the RequestReport operation. This is a request to xSellco to generate a specific report.

Submit a request using the GetReportRequestList operation to get a list that shows the report requests and the status and ID of each report request. API returns a ReportRequestId for every report requested per RequestType. When xSellco sets the status of a report request to DONE, the report is ready to be retrieved. Some reports create a GeneratedReportId that you can pass to the GetReport operation.

If no GeneratedReportId was created, submit a request using the GetReportList operation and include the ReportRequestId for the report requested. The operation returns a ReportId that you can then pass to the GetReport operation.

Submit a request using the GetReport operation to receive a specific report. You include in the request the GeneratedReportId or the ReportId for the report you want to receive.

The following steps shows the process for submitting and receiving an on-request report:

Seller submits a RequestReport operation, xSellco receives request, returns ReportRequestId.
Seller submits a GetReportRequestList operation xSellco returns the processing status and when DONE, reports return the GeneratedReportId.
Seller submits a GetReportList operation using the ReportRequestId obtain the ReportId.
Seller submits a GetReport operation using the ReportId to download file or data.

ReportType enumeration

Report Types available:

Value	Description
OVERVIEW_STATISTICS	Some key statistics including number of tickets and active users over the selected period
USER_AUDIT_LOG	A list of actions by all users over the selected period
TICKETS_SLA_BREACHES	All tickets that have breached the SLA
CUSTOMER_SATISFACTION	All tickets that have CSAT sent/blocked
RESOLVED_TICKETS	All tickets marked as Resolved within the selected period
CHANNEL_RESPONSE_STATISTICS	The number of responses within each set time category and the total number as a percentage of all tickets
AVERAGE_CHANNEL_HANDLING_TIME	The min, max and average handling time per channel
AVERAGE_USER_RESPONSE_TIME	The min, max and average handling time per user
AVERAGE_USER_HANDLING_TIME	The average time taken for the number of replies per user
USER_ACTIVITY_SUMMARY	The time taken on activities per ticket (including creating the ticket, status changes, replies and internal notes) per user
USER_RESPONSE_LOG	A summary of data relating to replies by all users over the selected
CHAT_OVERVIEW	Some key statistics including ticket details, time, information and ratings

ProcessingStatus enumeration

Value	Description
SUBMITTED	Request is pending to be processed
PROCESSING	Report generation is processing
CANCELLED	Report generation has been cancelled
DONE	Report is available for download