Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.
The Reports API section of the Amazon Marketplace Web Service (Amazon MWS) API lets you request various reports that help you manage your Sell on Amazon business. Report types are specified using the ReportTypes enumeration.
Amazon periodically adds new fields and field values to reports. Be sure to build report parsers into your Amazon MWS applications that can gracefully handle these types of report updates. For more information, see Building robust Amazon MWS applications.
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:
The following flowchart shows the process for submitting and receiving an on-request report:
You can also schedule order report requests so that they are submitted periodically by using the ManageReportSchedule operation. The Schedule enumeration is used to specify the time period for submitting report requests. You can also get a list of scheduled order report requests using the GetReportScheduleList operation.
The following flowchart shows the process for submitting and receiving a scheduled report:
The Reports API section contains the following operations:
Operation | Description | Availability |
---|---|---|
RequestReport | Creates a report request and submits the request to Amazon MWS. | All marketplaces. |
GetReportRequestList | Returns a list of report requests that you can use to get the ReportRequestId for a report. | All marketplaces. |
GetReportRequestListByNextToken | Returns a list of report requests using the NextToken, which was supplied by a previous request to either GetReportRequestListByNextToken or GetReportRequestList, where the value of HasNext was true in that previous request. | All marketplaces. |
GetReportRequestCount | Returns a count of report requests that have been submitted to Amazon MWS for processing. | All marketplaces. |
CancelReportRequests | Cancels one or more report requests. | All marketplaces. |
GetReportList | Returns a list of reports that were created in the previous 90 days. | All marketplaces. |
GetReportListByNextToken | Returns a list of reports using the NextToken, which was supplied by a previous request to either GetReportListByNextToken or GetReportList, where the value of HasNext was true in the previous call. | All marketplaces. |
GetReportCount | Returns a count of the reports, created in the previous 90 days, with a status of _DONE_ and that are available for download. | All marketplaces. |
GetReport | Returns the contents of a report and the Content-MD5 header for the returned report body. | All marketplaces. |
ManageReportSchedule | Creates, updates, or deletes a report request schedule for a specified report type. | All marketplaces. |
GetReportScheduleList | Returns a list of order report requests that are scheduled to be submitted to Amazon MWS for processing. | All marketplaces. |
GetReportScheduleListByNextToken | Currently this operation can never be called because the GetReportScheduleList operation cannot return more than 100 results. It is included for future compatibility. | All marketplaces. |
GetReportScheduleCount | Returns a count of order report requests that are scheduled to be submitted to Amazon MWS. | All marketplaces. |
UpdateReportAcknowledgements | Updates the acknowledged status of one or more reports. | All marketplaces. |