Product Fees v0 Use Case Guide

How to use the Product Fees API.

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

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

Body parameters

NameDescriptionSchema
FeesEstimateRequestA product, marketplace, and proposed price used to request estimated fees.Type: FeesEstimateRequest
  1. 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:

NameDescription
GetMyFeesEstimatesResponseEstimated fees for a list of products.
Type: array

GetMyFeesEstimateResponse

NameDescriptionSchema
StatusThe status of the fee request. Possible values: Success, ClientError, ServiceErrorstring
FeesEstimateIdentifierInformation 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:

NameDescriptionRequired
MarketplaceIdA marketplace identifier.
Type: string
Yes
IsAmazonFulfilledWhen true, the offer is fulfilled by Amazon.
Type: boolean
No
PriceToEstimateFeesThe product price that the fee estimate is based on.
Type: PriceToEstimateFees
Yes
IdentifierA unique identifier provided by the caller to track this request.
Type: string
Yes
IdTypeThe type of product identifier used in a FeesEstimateByIdRequest.
Type: enum (ASIN or Seller SKU)
Yes
IdValueThe item identifier.
Type: string
Yes

PriceToEstimateFees

NameDescriptionRequired
ListingPriceThe price of the item.
Type: string
Yes
ShippingThe shipping cost.
Type: boolean
No
PointsThe number of Amazon Points offered with the purchase of an item.
Type: points
Yes

FeesEstimateIdentifier

NameDescriptionRequired
MarketplaceIdA marketplace identifier.
Type: string
Yes
IsAmazonFulfilledWhen true, the offer is fulfilled by Amazon.
Type: boolean
No
SellerIdThe seller identifier.
Type: string
No
SellerInputIdentifierA unique identifier provided by the caller to track this request.
Type: string
No
PriceToEstimateFeesThe product price that the fee estimate is based on.
Type: PriceToEstimateFees
Yes
IdentifierA unique identifier provided by the caller to track this request.
Type: string
Yes
IdTypeThe type of product identifier used in a FeesEstimateByIdRequest.
Type: enum (ASIN or Seller SKU)
Yes
IdValueThe item identifier.
Type: string
Yes

Fees Estimate

NameDescriptionRequired
TimeOfFeesEstimationThe time at which the fees were estimated. This defaults to the time the request is made.
string (date-time)
Yes
TotalFeesEstimateTotal estimated fees for a given item, price, and fulfillment channel.
Type: MoneyType
No
FeeDetailListA list of other fees that contribute to a given fee.
Type: FeeDetailList
No

Points

NameSchemaRequired
PointsNumberInteger (int32)No
PointsMonetaryValueMoneyTypeNo

MoneyType

NameSchemaRequired
CurrencyCodeInteger (int32)No
AmountMoneyTypeNo