productFees_getMyFeesEstimateForSKU

Estimate Amazon fees (referral fee + FBA/MFN fees) for a seller SKU at a given price.

readAmazon Seller (SP-API)sp.productFeesV0

Amazon SP-API · getMyFeesEstimateForSKU · POST /products/fees/v0/listings/{SellerSKU}/feesEstimate Uses Product Fees v0 API. SKU-based estimates use actual item measurements after the item has been sent to Amazon — more accurate than ASIN-based estimates for FBA sellers. Pass isFba=True for FBA items. Net margin = price − data.totalFeesEstimate.Amount − COGS; never compute it when data.error is set.

Call it

In an AI client (MCP)

tools/call
{
  "name": "productFees_getMyFeesEstimateForSKU",
  "arguments": {
    "store": "myStore-US",
    "sellerSku": "<sellerSku>",
    "price": 1
  }
}

From code (Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/productFees_getMyFeesEstimateForSKU \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","sellerSku":"<sellerSku>","price":1}'
Early access — the Tool API is open on request, contact us.

Arguments

NameTypeDescription
storerequiredstringthe store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim.
sellerSkurequiredstringSeller's SKU for the item (URL encoding handled automatically).
pricerequirednumberListing price to estimate fees for (e.g. 29.99).
currencystringISO 4217 currency code for `price`. Omit to use the store marketplace's own currency (AE→AED, GB→GBP, JP→JPY, US→USD, …) — only pass this to override.
shippingPricenumberShipping price included in the estimate (MFN only). Default None.
isFbabooleanTrue for FBA fee estimate, False for MFN (merchant fulfilled). Default False.Default: false
pointsobjectAmazon Points offered with the purchase — Japan only. Shape {PointsNumber: int, PointsMonetaryValue: {Amount: float, CurrencyCode: str}}. Points reduce the price basis the referral fee is computed on.
optionalFulfillmentProgramstringFBA program override, only used when isFba=True; FBA_CORE is the default and FBA_SNL (Small and Light) is sunset — do not pass it.

Result

Every tool answers {notification, data, human_action}; data carries:

  • data.sellerSku — the queried SKU.
  • data.price — the price used for estimation.
  • data.isFba — whether FBA or MFN fees were estimated.
  • data.status — 'Success' or error status from Amazon.
  • data.totalFeesEstimate — {Amount, CurrencyCode} — total estimated fees.
  • data.error — null on success; on failure Amazon's {Type, Code, Message} saying WHY there is no estimate, and the Message is in notification.message too. A refused estimate is not zero fees — never write a blank or 0 fee to your sheet when data.error is set, because any margin computed from it is wrong.
  • data.feeDetail — list of per-fee breakdown objects, each with: - FeeType: e.g. 'ReferralFee', 'FBAFees', 'VariableClosingFee' - FeeAmount: {Amount, CurrencyCode} - FinalFee: {Amount, CurrencyCode}

Body (Amazon schema)

FeesEstimateRequest: {MarketplaceId*, IsAmazonFulfilled, PriceToEstimateFees*: {ListingPrice*, Shipping, Points}, Identifier*, OptionalFulfillmentProgram: FBA_CORE | FBA_SNL | FBA_EFN}

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude