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

Response format

Success response

In response to an HTTP request, Amazon MWS returns an XML file that contains the results of the request. If a request is successful, the response is returned with the data requested. The following example shows a successful response.

<?xml version="1.0"?>
<RequestReportResponse xmlns="http://mws.amazonservices.com/doc/2009-01-01/">
    <RequestReportResult>
        <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>_SUBMITTED_</ReportProcessingStatus>
        </ReportRequestInfo>
    </RequestReportResult>
    <ResponseMetadata>
        <RequestId>88faca76-b600-46d2-b53c-0c8c4533e43a</RequestId>
    </ResponseMetadata>
</RequestReportResponse>
Important: You should record and retain for 30 days the RequestId and Timestamp for every request that you submit to Amazon MWS. Doing this enables Amazon to diagnose and fix any problems that you might encounter, helping to improve your experience using Amazon MWS. Without this information, requests to Amazon MWS support will take longer to resolve.

Error response

If a request is unsuccessful, the main response element is ErrorResponse, irrespective of the action requested. This element contains one or more Error child elements. Each Error includes:
  • An error code that identifies the type of error that occurred.
  • A message code that describes the error condition in a human-readable form.
  • An error type, identifying either the receiver or the sender as the originator of the error.

For more information about errors and error handling, see Error Messages.

The following example shows an error response: 

<ErrorResponse xmlns="http://mws.amazonservices.com/doc/2009-01-01/">
    <Error>
        <Type>Sender</Type>
        <Code>InvalidClientTokenId</Code>
        <Message> The AWS Access Key Id you provided does not exist in our records. </Message>
        <Detail>com.amazonservices.mws.model.Error$Detail@17b6643</Detail>
    </Error>
    <RequestID>b7afc6c3-6f75-4707-bcf4-0475ad23162c</RequestID>
</ErrorResponse>

XML Character Limits

XML responses are limited to the Unicode characters compatible with the Extensible Markup Language (XML) 1.0:

Char ::= #x9 | #xA | #xD | [#x20-#xD7FF] | [#xE000-#xFFFD] | [#x10000-#x10FFFF]

If a response includes a character outside of that range, Amazon MWS returns Unicode #xFFFD (�) in place of that character.