Skip to main content

Get Amazon Fee Estimate (Live)

POST 
/api/v2/pro-forma/amazon-fees

Live Amazon SP-API Product Fees v0 estimate for a price/fulfillment combination.

Body fields:

  • integration_instance_id (required, integer) — Amazon integration instance
  • id_type (required, string) — sku (existing listing, seller SKU) or asin (catalog item)
  • id_value (required, string, max 255) — the seller SKU or ASIN
  • price (required, numeric, min 0.01) — listing price to estimate fees at
  • is_amazon_fulfilled (required, boolean) — true = FBA (sends OptionalFulfillmentProgram FBA_CORE), false = FBM
  • refresh (optional, boolean) — bypass the 24h cache and force a live SP-API call

Results are cached for 24 hours on the exact parameter tuple; cached + fetched_at in the response indicate provenance. Amazon SP-API rate limit is 1 rps — keep refresh use sparing. The endpoint is throttled to 30 requests/minute (throttle:30,1,pro-forma-amazon-fees); exceeding it returns 429 Too Many Requests.

When Amazon is unreachable or rejects the request, returns 422 with an IntegrationApiError error so the client can fall back to rate-card defaults.

Requires Bearer token (products scope).

Request​

Responses​

OK

Response Headers
    Content-Type