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

Example HTTP errors

This section shows some common Amazon MWS error code examples and possible solutions to the error.

503 service unavailable error

Reason

This 503 error indicates that the Amazon MWS service is unavailable. When you use the client library, the response is parsed and a MarketplacewebService exception with all data included is thrown.

How to troubleshoot

Retry the request using an "exponential backoff" approach, as described in Handling errors: Service errors.

Show example code Hide example code

POST 
mws.amazonservices.com
/Reports/2009-01-01
?AWSAccessKeyId=AKIAJSTDR2444BJQ
&AWSAccountId=458080
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&Marketplace=ATVPDKIKX0DER
&SellerId=AC28N11YUQ
&SignatureVersion=2
&Version=2009-01-01
&RequestId=2d093e-0408-4517-9685-
474d1a0a8e9e
&CustomerId=A2AR6RWNQ
&NamespaceUri=
http%3A%2F%2Fmws.amazonservices.com
%2Fdoc%2F2009-01-01%2F
&ServiceName=MarketplaceWebService
&Action=GetReportList
&ErrorCode=ServiceUnavailable
&ErrorFault=Receiver 
HTTP/0.0" 503 296 "-" "UST/1.0 
(Language=PHP/5.2.14; 
MWSClientVersion=2009-07-02; 
Platform=Linux infong 2.4 #1 
SMP Wed Nov 4 21:12:12 
UTC 2009 i686 GNU/Linux/Linux 
infong 2.4 #1 SMP 
Wed Nov 4 21:12:12 UTC 2009 i686 
GNU/Linux/Linux infong 2.4 
#1 SMP Wed Nov 4 21:12:12 UTC 
2009 i686 GNU/Linux)

↑ Top

503 throttling error

Reason

This 503 error indicates that your request is being throttled. When you use the client library, the response is parsed and a MarketplacewebService exception with all data included is thrown.

How to troubleshoot

Check the throttling limit in the API documentation for the type of request you are submitting. Set up your retry logic to resend the request when the appropriate amount of time has passed to prevent throttling.

Show example code Hide example code

POST 
mws.amazonservices.com
/Reports/2009-01-01
?AWSAccessKeyId=AKIVUUNIIMFTA
&AWSAccountId=7948
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&Marketplace=ATVPDKIKX0DER
&SellerId=ASH1H4EF
&SignatureVersion=2
&Version=2009-01-01
&RequestId=260-0116-41fa-91d0-7bc98359c694
&CustomerId=ASH14EF
&NamespaceUri=
http%3A%2F%2Fmws.amazonservices.com
%2Fdoc%2F2009-01-01%2F
&ServiceName=MarketplaceWebService
&Action=GetReportRequestList
&ErrorCode=RequestThrottled
&ErrorFault=Sender
HTTP/0.0" 503 309 "-" "null"

↑ Top