Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation
Amazon MWS Documentation

Required request parameters

The following table describes the request parameters that are requred for all Amazon MWS operations:
Name Description Required Valid values
AWSAccessKeyId Your Amazon MWS account is identified by your access key Id, which Amazon MWS uses to look up your Secret Access Key. Yes The AWSAccessKeyId that you received when you registered for Amazon MWS.

Type: xs:string

Action The action you want to perform on the endpoint, such as the operation GetFeedSubmissionResult. Yes Any valid action for the endpoint you are calling.

Type: xs:string

MWSAuthToken Represents the authorization of a specific developer by a specific Amazon seller. For web applications and third-party developer authorizations only. The authorization token that you received when you registered for Amazon MWS.

Type: xs:string

SellerId or Merchant Your seller or merchant identifier. Yes The seller or merchant identifier that you received when you registered for Amazon MWS.

Type: xs:string

Signature Part of the authentication process that is used for identifying and verifying who is sending a request. Yes For more information on how to calculate the signature, see Using the Amazon MWS client libraries.

Type: xs:string

SignatureMethod The HMAC hash algorithm you are using to calculate your signature. Both HmacSHA256 and HmacSHA1 are supported hash algorithms, but Amazon recommends using HmacSHA256. Yes SignatureMethod values:
  • HmacSHA256 (recommended)
  • HmacSHA1

Type: xs:string

SignatureVersion Which signature version is being used. This is Amazon MWS-specific information that tells Amazon MWS the algorithm you used to form the string that is the basis of the signature. Yes SignatureVersion values:
  • 2

Type: xs:string

Timestamp Each request must contain the timestamp of the request. Depending on the API operation you are using, you can provide an expiration date and time for the request instead of the timestamp. In ISO 8601 date time format. Yes The current date and time or the expiration date and time for the request in ISO 8601 date time format.

Type: xs:dateTime

Version The version of the API section being called. Yes The version of the API section being called.

Type: xs:string

Example request

Get request method

Show example code Hide example code

https://mws.amazonservices.com/CustomerInformation/2014-03-01/
?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ
&Action=ListCustomers
&DateRangeEnd=2014-04-30T00%3A06%3A07.000Z
&DateRangeStart=2014-04-01T00%3A06%3A07.000Z
&DateRangeType=AssociatedDate
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&SellerId=A1IMEXAMPLEWRC
&Signature=FUbIEXAMPLETUGtTS6sqNDt3OuLH8tbhz5YEXAMPLEw%3D
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2014-04-01T21%3A53%3A02Z
&Version=2014-03-01

↑ Top

Post request method

Show example code Hide example code

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

AWSAccessKeyId=0PExampleR2
&Action=CancelFeedSubmissions
&FeedSubmissionIdList.Id.1=1058369303
&FeedTypeList.Type.1=_POST_PRODUCT_DATA_
&FeedTypeList.Type.2=_POST_PRODUCT_PRICING_DATA_
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&Marketplace=ATExampleER
&SellerId=A1ExampleE6
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2009-02-04T17%3A34%3A14.203Z
&Version=2009-01-01
&Signature=0RExample0%3D

↑ Top