What is the Product Fees API?

The Product Fees API retrieves product fees for multiple products. You can use the getMyFeesEstimates operation to get product fee estimates for a list of products and marketplaces, and then set prices based on those fee estimates. You must specify your products by ASIN or SKU (not UPC, ISBN, etc).

You must include an original identifier in each product fees request. This identifier is included in the fees estimate so that you can correlate a fees estimate with an original request.

This operation allows up to 20 product requests in a single batch.

Important: The estimated fees returned by this API are not guaranteed. Actual fees may vary.

Tutorial: Get product fees estimates by ASINs or SKUs

This tutorial demonstrates how to retrieve product fees for a set of SKUs.

Prerequisites

To successfully complete this tutorial, you must have the following:

• Authorization from the selling partner for whom you are making calls. Refer to the Selling Partner API Developer Guide (opens new window) for more information.
• The Pricing and Product Listing role assigned to your developer profile.
• The Pricing and Product Listing role selected in the App registration page for your application.
• A basic understanding of the Selling Partner API. Refer to the Selling Partner API Developer Guide (opens new window) for more information.

Step 1. Call the getMyFeesEstimates operation

1. Call the getMyFeesEstimate operation, passing the following parameters:

Body parameters

Name	Description	Schema
FeesEstimateRequest	A product, marketplace, and proposed price used to request estimated fees.	Type: FeesEstimateRequest

2. Pass an array with up to 20 FeesEstimateRequest objects.

Request example

POST https://sellingpartnerapi-na.amazon.com/products/fees/v0/feesEstimate
[
  {
    "FeesEstimateRequest": {
      "MarketplaceId": "ATVPDKIKX0DER",
      "IsAmazonFulfilled": false,
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "USD",
          "Amount": 12
        },
        "Shipping": {
          "CurrencyCode": "USD",
          "Amount": 2
        }
      },
      "Identifier": "SCSID1"
    },
    "IdType": "SellerSKU",
    "IdValue": "ZZZZZZZ"
  }
]

Response

Response properties:

Name	Description
GetMyFeesEstimatesResponse	Estimated fees for a list of products. Type: array

GetMyFeesEstimateResponse

Name	Description	Schema
Status	The status of the fee request. Possible values: Success, ClientError, ServiceError	string
FeesEstimateIdentifier	Information used to identify a fees estimate request.	FeesEstimateIdentifier

Response example:

{
  "Status": "Success",
  "FeesEstimateIdentifier": {
    "MarketplaceId": "ATVPDKIKX0DER",
    "IdType": "ASIN",
    "SellerId": "AXXXXXXXXXXXXX",
    "SellerInputIdentifier": "SCSID1",
    "IsAmazonFulfilled": false,
    "IdValue": "asin123",
    "PriceToEstimateFees": {
      "ListingPrice": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Shipping": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Points": {
        "PointsNumber": 0,
        "PointsMonetaryValue": {
          "CurrencyCode": "USD",
          "Amount": 0
        }
      }
    }
  }
}  

Step 2. Call the FeesEstimateRequest operation

Call the feesEstimateRequest operation, passing the following parameters:

Name	Description	Required
MarketplaceId	A marketplace identifier. Type: string	Yes
IsAmazonFulfilled	When true, the offer is fulfilled by Amazon. Type: boolean	No
PriceToEstimateFees	The product price that the fee estimate is based on. Type: PriceToEstimateFees	Yes
Identifier	A unique identifier provided by the caller to track this request. Type: string	Yes
IdType	The type of product identifier used in a FeesEstimateByIdRequest. Type: enum (ASIN or Seller SKU)	Yes
IdValue	The item identifier. Type: string	Yes

PriceToEstimateFees

Name	Description	Required
ListingPrice	The price of the item. Type: string	Yes
Shipping	The shipping cost. Type: boolean	No
Points	The number of Amazon Points offered with the purchase of an item. Type: points	Yes

FeesEstimateIdentifier

Name	Description	Required
MarketplaceId	A marketplace identifier. Type: string	Yes
IsAmazonFulfilled	When true, the offer is fulfilled by Amazon. Type: boolean	No
SellerId	The seller identifier. Type: string	No
SellerInputIdentifier	A unique identifier provided by the caller to track this request. Type: string	No
PriceToEstimateFees	The product price that the fee estimate is based on. Type: PriceToEstimateFees	Yes
Identifier	A unique identifier provided by the caller to track this request. Type: string	Yes
IdType	The type of product identifier used in a FeesEstimateByIdRequest. Type: enum (ASIN or Seller SKU)	Yes
IdValue	The item identifier. Type: string	Yes

Fees Estimate

Name	Description	Required
TimeOfFeesEstimation	The time at which the fees were estimated. This defaults to the time the request is made. string (date-time)	Yes
TotalFeesEstimate	Total estimated fees for a given item, price, and fulfillment channel. Type: MoneyType	No
FeeDetailList	A list of other fees that contribute to a given fee. Type: FeeDetailList	No

Points

Name	Schema	Required
PointsNumber	Integer (int32)	No
PointsMonetaryValue	MoneyType	No

MoneyType

Name	Schema	Required
CurrencyCode	Integer (int32)	No
Amount	MoneyType	No