HomeDocumentationCode SamplesAnnouncementsModelsRelease NotesFAQGitHubVideos
Developer HubAPI StatusSupport
Documentation
Developer HubAPI StatusSupport

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, or other identifiers).

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.

Important

The estimated fees returned by this API are not guaranteed. Actual fees can vary.

Prerequisites

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

  • Authorization from the selling partner for whom you are making calls. Refer to Authorizing Selling Partner API Applications 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.

Tutorial 1: Get product fee estimates for a specific SKU

This tutorial demonstrates how to retrieve product fees for a SKU.

Call getMyFeesEstimateForSKU to retrieve fee estimates for an item

You can call the getMyFeesEstimateForSKU operation for an item on behalf of a selling partner before the selling partner sets the item's price. This operation accepts a SKU as a path parameter.

Path parameters

Name Description Schema
SellerSKU Used to identify an item in a given marketplace. SellerSKU is qualified by the seller's SellerId, which is included with every operation that you submit. Type: string

Body parameters

Name Description Schema
body The request body schema for the getMyFeesEstimateForSKU operation. Type: GetMyFeesEstimateRequest

Request example:

POST https://sellingpartnerapi-na.amazon.com/products/fees/v0/listings/UmaS1/feesEstimate
{
  "FeesEstimateRequest": {
    "MarketplaceId": "ATVPDKIKX0DER",
    "IsAmazonFulfilled": false,
    "PriceToEstimateFees": {
      "ListingPrice": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Shipping": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Points": {
        "PointsNumber": 0,
        "PointsMonetaryValue": {
          "CurrencyCode": "USD",
          "Amount": 0
        }
      }
    },
    "Identifier": "UmaS1"
  }
}

Response

A successful response includes the following:

{
  "FeesEstimateResult": {
    "Status": "Success",
    "FeesEstimateIdentifier": {
      "MarketplaceId": "ATVPDKIKX0DER",
      "IdType": "SellerSKU",
      "SellerId": "AXXXXXXXXXXXXX",
      "SellerInputIdentifier": "UmaS1",
      "IsAmazonFulfilled": false,
      "IdValue": "UmaS1",
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Shipping": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Points": {
          "PointsNumber": 0,
          "PointsMonetaryValue": {
            "CurrencyCode": "USD",
            "Amount": 0
          }
        }
      }
    },
    "FeesEstimate": {
      "TimeOfFeesEstimation": "Mon Oct 28 18:49:32 UTC 2019",
      "TotalFeesEstimate": {
        "CurrencyCode": "USD",
        "Amount": 3.0
      },
      "FeeDetailList": [
        {
          "FeeType": "PerItemFee",
          "FeeAmount": {
            "CurrencyCode": "USD",
            "Amount": 0.0
          },
          "FinalFee": {
            "CurrencyCode": "USD",
            "Amount": 0.0
          },
          "FeePromotion": {
            "CurrencyCode": "USD",
            "Amount": 0.0
          }
        }
      ]
    },
    "Error": {
      "Type": "",
      "Code": "",
      "Message": "",
      "Detail": []
    }
  }
}

Tutorial 2: Get product fee estimates for a specific ASIN

This tutorial demonstrates how to retrieve product fees for an ASIN.

Call the getMyFeesEstimateForASIN operation to retrieve fee estimates for an item

You can call the getMyFeesEstimateForASIN operation for an item on behalf of a selling partner before the selling partner sets the item's price. This operation accepts an ASIN as a path parameter.

Path parameters

Name Description Schema
ASIN The Amazon Standard Identification Number (ASIN) of the item. Type: string

Body parameters

Name Description Schema
body The request body schema for the getMyFeesEstimateForASIN operation. Type: GetMyFeesEstimateRequest

Request example:

POST https://sellingpartnerapi-na.amazon.com/products/fees/v0/items/UmaS1/feesEstimate
{
  "FeesEstimateRequest": {
    "MarketplaceId": "ATVPDKIKX0DER",
    "IsAmazonFulfilled": false,
    "PriceToEstimateFees": {
      "ListingPrice": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Shipping": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Points": {
        "PointsNumber": 0,
        "PointsMonetaryValue": {
          "CurrencyCode": "USD",
          "Amount": 0
        }
      }
    },
    "Identifier": "UmaS1"
  }
}

Response

A successful response includes the following:

{
  "FeesEstimateResult": {
    "Status": "Success",
    "FeesEstimateIdentifier": {
      "MarketplaceId": "ATVPDKIKX0DER",
      "IdType": "ASIN",
      "SellerId": "AXXXXXXXXXXXXX",
      "SellerInputIdentifier": "UmaS1",
      "IsAmazonFulfilled": false,
      "IdValue": "B00V5DG6IQ",
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Shipping": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Points": {
          "PointsNumber": 0,
          "PointsMonetaryValue": {
            "CurrencyCode": "USD",
            "Amount": 0
          }
        }
      }
    },
    "FeesEstimate": {
      "TimeOfFeesEstimation": "Mon Oct 28 18:49:32 UTC 2019",
      "TotalFeesEstimate": {
        "CurrencyCode": "USD",
        "Amount": 3
      },
      "FeeDetailList": [
        {
          "FeeType": "PerItemFee",
          "FeeAmount": {
            "CurrencyCode": "USD",
            "Amount": 0
          },
          "FinalFee": {
            "CurrencyCode": "USD",
            "Amount": 0
          },
          "FeePromotion": {
            "CurrencyCode": "USD",
            "Amount": 0
          }
        }
      ]
    },
    "Error": {
      "Type": "",
      "Code": "",
      "Message": "",
      "Detail": []
    }
  }
}

Tutorial 3: Get product fees for a batched set of up to 20 items

This tutorial demonstrates how to retrieve product fees for a set of up to 20 SKUs or ASINs.

Step 1. Create an array of FeesEstimateByIdRequest objects

The getMyFeesEstimates operation allows up to 20 product requests in a single batch. In order to send 20 requests in one API call, you must create an array with up to 20 FeesEstimateByIdRequest objects.

Example of an array of FeesEstimateByIdRequest objects:

[
  {
    "FeesEstimateRequest": {
      "MarketplaceId": "ATVPDKIKX0DER",
      "IsAmazonFulfilled": false,
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Shipping": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Points": {
          "PointsNumber": 0,
          "PointsMonetaryValue": {
            "CurrencyCode": "USD",
            "Amount": 0
          }
        }
      },
      "Identifier": "UmaS1"
    },
    "IdType": "ASIN",
    "IdValue": "asin123"
  },
  {
    "FeesEstimateRequest": {
      "MarketplaceId": "A1AM78C64UM0Y8",
      "IsAmazonFulfilled": true,
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "MXN",
          "Amount": 10
        },
        "Shipping": {
          "CurrencyCode": "MXN",
          "Amount": 10
        },
        "Points": {
          "PointsNumber": 0,
          "PointsMonetaryValue": {
            "CurrencyCode": "MXN",
            "Amount": 0
          }
        }
      },
      "Identifier": "UmaS2"
    },
    "IdType": "SellerSKU",
    "IdValue": "sku123"
  },
  ...
]

Step 2. Call the getMyFeesEstimates operation

Call the getMyFeesEstimates operation, passing the following parameters:

Body parameters

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

Request example

POST https://sellingpartnerapi-na.amazon.com/products/fees/v0/feesEstimate
[
  {
    "FeesEstimateRequest": {
      "MarketplaceId": "ATVPDKIKX0DER",
      "IsAmazonFulfilled": false,
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Shipping": {
          "CurrencyCode": "USD",
          "Amount": 10
        },
        "Points": {
          "PointsNumber": 0,
          "PointsMonetaryValue": {
            "CurrencyCode": "USD",
            "Amount": 0
          }
        }
      },
      "Identifier": "UmaS1"
    },
    "IdType": "ASIN",
    "IdValue": "asin123"
  },
  {
    "FeesEstimateRequest": {
      "MarketplaceId": "A1AM78C64UM0Y8",
      "IsAmazonFulfilled": true,
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "MXN",
          "Amount": 10
        },
        "Shipping": {
          "CurrencyCode": "MXN",
          "Amount": 10
        },
        "Points": {
          "PointsNumber": 0,
          "PointsMonetaryValue": {
            "CurrencyCode": "MXN",
            "Amount": 0
          }
        }
      },
      "Identifier": "UmaS2"
    },
    "IdType": "SellerSKU",
    "IdValue": "sku123"
  }
]

Response

A successful response includes the following:

Name Description Schema
GetMyFeesEstimatesResponse Estimated fees for a list of products.

Type: array

Type: GetMyFeesEstimatesResponse

Response example:

{
  "Status": "Success",
  "FeesEstimateIdentifier": {
    "MarketplaceId": "ATVPDKIKX0DER",
    "IdType": "ASIN",
    "SellerId": "AXXXXXXXXXXXXX",
    "SellerInputIdentifier": "UmaS1",
    "IsAmazonFulfilled": false,
    "IdValue": "asin123",
    "PriceToEstimateFees": {
      "ListingPrice": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Shipping": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Points": {
        "PointsNumber": 0,
        "PointsMonetaryValue": {
          "CurrencyCode": "USD",
          "Amount": 0
        }
      }
    }
  },
  "FeesEstimate": {
    "TimeOfFeesEstimation": "Mon Oct 28 18:49:32 UTC 2019",
    "TotalFeesEstimate": {
      "CurrencyCode": "USD",
      "Amount": 3.0
    },
    "FeeDetailList": []
  },
  "Error": {
    "Type": "",
    "Code": "",
    "Message": "",
    "Detail": []
  }
},
{
  "Status": "Success",
  "FeesEstimateIdentifier": {
    "MarketplaceId": "A1AM78C64UM0Y8",
    "IdType": "SellerSKU",
    "SellerId": "AXXXXXXXXXXXXX",
    "SellerInputIdentifier": "UmaS2",
    "IsAmazonFulfilled": false,
    "IdValue": "sku123",
    "PriceToEstimateFees": {
      "ListingPrice": {
        "CurrencyCode": "MXN",
        "Amount": 10
      },
      "Shipping": {
        "CurrencyCode": "MXN",
        "Amount": 10
      },
      "Points": {
        "PointsNumber": 0,
        "PointsMonetaryValue": {
          "CurrencyCode": "MXN",
          "Amount": 0
        }
      }
    }
  },
  "FeesEstimate": {
    "TimeOfFeesEstimation": "Mon Oct 28 18:49:32 UTC 2019",
    "TotalFeesEstimate": {
      "CurrencyCode": "MXN",
      "Amount": 3.0
    },
    "FeeDetailList": []
  },
  "Error": {
    "Type": "",
    "Code": "",
    "Message": "",
    "Detail": []
  }
}