API Version: v0

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 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 for more information.

Step 1. Call the getMyFeesEstimates operation

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`

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