Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

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.

Amazon MWS Documentation

CancelReportRequests

Cancels one or more report requests.

Description

The CancelReportRequests operation cancels one or more report requests, returning the count of the canceled report requests and the report request information. You can cancel more than 100 report requests, but information is only returned for the first 100 report requests canceled. To return information on a greater number of canceled report requests, use the GetReportRequestList operation.

Note: If report requests have already begun processing, they cannot be canceled.

Availability

This operation is available in all marketplaces.

Throttling

Maximum request quota Restore rate Hourly request quota
10 requests One request every 45 seconds 80 requests per hour
For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.

Request parameters

For more information about the request parameters that are required for all Amazon MWS operations, see Required request parameters in the Amazon MWS Developer Guide.

Name Description Required Values
ReportRequestIdList A structured list of ReportRequestId values. If you pass in ReportRequestId values, other query conditions are ignored. No Default: All

Type: List of Type: xs:string

ReportTypeList A structured list of ReportType enumeration values. No Default: All

Type: List of Type: xs:string

ReportProcessingStatusList A structured list of report processing statuses by which to filter report requests. No ReportProcessingStatusList values:
  • _SUBMITTED_
  • _IN_PROGRESS_
  • _CANCELLED_
  • _DONE_
  • _DONE_NO_DATA_

Default: All

Type: List of Type: xs:string

RequestedFromDate The start of the date range used for selecting the data to report, in ISO 8601 date time format. No Default: 90 days ago

Type: xs:dateTime

RequestedToDate The end of the date range used for selecting the data to report, in ISO 8601 date time format. No Default: Now

Type: xs:dateTime

Response elements

Name Description
Count A non-negative integer that represents the total number of report requests that were canceled.

Type: xs:nonNegativeInteger

ReportRequestInfo Detailed information about a report request that was canceled.

Type: ReportRequestInfo

Examples

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

POST /Reports/2009-01-01 HTTP/1.1
Content-Type: x-www-form-urlencoded
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header>

AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2
&Action=CancelReportRequests
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&Marketplace=ATVPDKIKX0DER
&ReportProcessingStatusList.Status.1=_SUBMITTED_
&ReportRequestIdList.Id.1=2291326454
&ReportTypeList.Type.1=_GET_ORDERS_DATA_
&ReportTypeList.Type.2=_GET_MERCHANT_LISTINGS_DATA_
&SellerId=A1XEXAMPLE5E6
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2009-02-04T18%3A12%3A22.421Z
&Version=2009-01-01
&Signature=wZFasNUpTth2GA5Xzuamb1XGVFY%3D

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<CancelReportRequestsResponse
    xmlns="http://mws.amazonservices.com/doc/2009-01-01/">
    <CancelReportRequestsResult>
        <Count>1</Count>
        <ReportRequestInfo>
            <ReportRequestId>2291326454</ReportRequestId>
            <ReportType>_GET_MERCHANT_LISTINGS_DATA_</ReportType>
            <StartDate>2009-01-21T02:10:39+00:00</StartDate>
            <EndDate>2009-02-13T02:10:39+00:00</EndDate>
            <Scheduled>false</Scheduled>
            <SubmittedDate>2009-02-20T02:10:39+00:00</SubmittedDate>
            <ReportProcessingStatus>_CANCELLED_</ReportProcessingStatus>
        </ReportRequestInfo>
    </CancelReportRequestsResult>
    <ResponseMetadata>
        <RequestId>a720f9d6-83e9-4684-bc35-065b41ed5ca4</RequestId>
    </ResponseMetadata>
</CancelReportRequestsResponse>

↑ Top