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.
Returns the estimated fees for a list of products.
The GetMyFeesEstimate operation takes a list of products and marketplaces returns the fees for those products in those marketplaces. You can call GetMyFeesEstimate for a set of products before setting prices on those products. Your prices can then take estimated fees into account. You must specify your products by ASIN or SKU (not UPC, ISBN, etc).
With each product fees request, you must include an original identifier. This identifier is included in the fees estimate so you can correlate a fees estimate with an original request.
This operation allows up to 20 product requests in a single batch. For more information on processing the result, see Processing bulk operation requests.
For more information on fees, see Selling on Amazon Fee Schedule and FBA features and fees on Seller Central.
This operation is available in all marketplaces.
Maximum request quota | Restore rate | Hourly request quota |
---|---|---|
20 requests | 10 items every second | 36000 requests per hour |
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 |
---|---|---|---|
FeesEstimateRequestList | A list of products, marketplaces, and other options to query for fees. | Yes | Maximum: 20 requests. Type: List of FeesEstimateRequest |
Amazon MWS returns an XML file that contains the response to a successful request or subscription. If the request is unsuccessful, the main response element is ErrorResponse. For more information, see Response format in the Amazon MWS Developer Guide.
The response elements that the GetMyFeesEstimate operation returns are described by the publicly available XSD ProductsAPI_Response.xsd. The top-level elements returned by the GetMyFeesEstimate operation are:
Name | Description | Required | Values |
---|---|---|---|
FeesEstimateResultList | A list of products and their estimated fees. | Yes | Type: List of FeesEstimateResult |
For information about standard request requirements, see Required request parameters.
POST /Products/2011-10-01 HTTP/1.1 Content-Type: x-www-form-urlencoded Host: mws.amazonservices.com User-Agent: <Your User Agent Header> FeesEstimateRequestList.FeesEstimateRequest.1.MarketplaceId= ATVPDKIKX0DER &FeesEstimateRequestList.FeesEstimateRequest.1.IdType=ASIN &FeesEstimateRequestList.FeesEstimateRequest.1.IdValue= B002KT3XQM &FeesEstimateRequestList.FeesEstimateRequest.1.IsAmazonFulfilled=true &FeesEstimateRequestList.FeesEstimateRequest.1.Identifier= request1 &FeesEstimateRequestList.FeesEstimateRequest.1.PriceToEstimateFees.ListingPrice.CurrencyCode=USD &FeesEstimateRequestList.FeesEstimateRequest.1.PriceToEstimateFees.ListingPrice.Amount=30.00 &FeesEstimateRequestList.FeesEstimateRequest.1.PriceToEstimateFees.Shipping.CurrencyCode=USD &FeesEstimateRequestList.FeesEstimateRequest.1.PriceToEstimateFees.Shipping.Amount=3.99 &FeesEstimateRequestList.FeesEstimateRequest.1.PriceToEstimateFees.Points.PointsNumber=0 &AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ &Action=GetMyFeesEstimate &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &SellerId=A1IMEXAMPLEWRC &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2012-12-04T22%3A03%3A05Z &Version=2011-10-01 &Signature=fJFzEXAMPLEEax1vAdKP7l3lwKQUH1r34lcEXAMPLEA%3D
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <GetMyFeesEstimateResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetMyFeesEstimateResult> <FeesEstimateResultList> <FeesEstimateResult> <Status>Success</Status> <FeesEstimateIdentifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <IdValue>B0002GTTRC</IdValue> <IdType>ASIN</IdType> <IsAmazonFulfilled>True</IsAmazonFulfilled> <PriceToEstimateFees> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>58.00</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </Shipping> <Points> <PointsNumber>0</PointsNumber> </Points> </PriceToEstimateFees> <SellerInputIdentifier>IDDDDDDDD</SellerInputIdentifier> </FeesEstimateIdentifier> <FeesEstimate> <TimeOfFeesEstimation>2015-07-19T23:15:11.859Z</TimeOfFeesEstimation> <TotalFeesEstimate> <CurrencyCode>USD</CurrencyCode> <Amount>10.00</Amount> </TotalFeesEstimate> <FeeDetailList> <FeeDetail> <FeeType>AmazonReferralFee</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>8.70</Amount> </FeeAmount> <FeePromotion> <CurrencyCode>USD</CurrencyCode> <Amount>1.00</Amount> </FeePromotion> <FinalFee> <CurrencyCode>USD</CurrencyCode> <Amount>7.70</Amount> </FinalFee> </FeeDetail> <FeeDetail> <FeeType>VariableClosingFee</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </FeeAmount> <FinalFee> <CurrencyCode>USD</CurrencyCode> <Amount>0.0</Amount> </FinalFee> </FeeDetail> <FeeDetail> <FeeType>FulfillmentFees</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>2.30</Amount> </FeeAmount> <FinalFee> <CurrencyCode>USD</CurrencyCode> <Amount>2.30</Amount> </FinalFee> <IncludedFeeList> <FeeDetail> <FeeType>OrderHandlingFee</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>1.00</Amount> </FeeAmount> <FinalFee> <CurrencyCode>USD</CurrencyCode> <Amount>1.00</Amount> </FinalFee> </FeeDetail> <FeeDetail> <FeeType>PickAndPackFee</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>0.30</Amount> </FeeAmount> <FinalFee> <CurrencyCode>USD</CurrencyCode> <Amount>0.30</Amount> </FinalFee> </FeeDetail> <FeeDetail> <FeeType>WeightHandlingFee</FeeType> <FeeAmount> <CurrencyCode>USD</CurrencyCode> <Amount>1.00</Amount> </FeeAmount> <FinalFee> <CurrencyCode>USD</CurrencyCode> <Amount>1.00</Amount> </FinalFee> </FeeDetail> </IncludedFeeList> </FeeDetail> </FeeDetailList> </FeesEstimate> </FeesEstimateResult> </FeesEstimateResultList> </GetMyFeesEstimateResult> <ResponseMetadata> <RequestId>21534f03-e7e3-4d9a-9bea-0e15add3326d</RequestId> </ResponseMetadata> </GetMyFeesEstimateResponse>
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <GetMyFeesEstimateResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetMyFeesEstimateResult> <FeesEstimateResultList> <FeesEstimateResult> <Status>ClientError</Status> <FeesEstimateIdentifier> <!-- Rest of the input parameters --> </FeesEstimateIdentifier> <Error> <Type>Sender</Type> <Code>InvalidParameterValue</Code> <Message> Attribute X is not valid for marketplace ATVPDKIKX0DER </Message> </Error> </FeesEstimateResult> </FeesEstimateResultList> </GetMyFeesEstimateResult> <ResponseMetadata> <RequestId>21534f03-e7e3-4d9a-9bea-0e15add3326d</RequestId> </ResponseMetadata> </GetMyFeesEstimateResponse>
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <GetMyFeesEstimateResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetMyFeesEstimateResult> <FeesEstimateResultList> <FeesEstimateResult> <Status>ServerError</Status> <FeesEstimateIdentifier> <!-- Rest of the input parameters --> </FeesEstimateIdentifier> <Error> <Type> Receiver </Type> <Code>InternalError</Code> <Message> There was an internal service failure. </Message> </Error> </FeesEstimateResult> </FeesEstimateResultList> </GetMyFeesEstimateResult> <ResponseMetadata> <RequestId>21534f03-e7e3-4d9a-9bea-0e15add3326d</RequestId> </ResponseMetadata> </GetMyFeesEstimateResponse>
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <GetMyFeesEstimateResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetMyFeesEstimateResult> <FeesEstimateResultList> <FeesEstimateResult> <Status>ServerError</Status> <FeesEstimateIdentifier> <!-- Rest of the input parameters --> </FeesEstimateIdentifier> <Error> <Type> Receiver </Type> <Code>DataNotAvailable</Code> <Message> Non-buyable item. Missing category. </Message> </Error> </FeesEstimateResult> </FeesEstimateResultList> </GetMyFeesEstimateResult> <ResponseMetadata> <RequestId>21534f03-e7e3-4d9a-9bea-0e15add3326d</RequestId> </ResponseMetadata> </GetMyFeesEstimateResponse>
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <ErrorResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <Error> <Type>Sender</Type> <Code>InvalidParameterValue</Code> <Message> There are more than 20 elements in FeesEstimateRequestList. </Message> <Detail/> </Error> <RequestID>9f17b9ff-2ef5-42fe-b956-6d9b38ac8422</RequestID> </ErrorResponse>