Skip to main content

Update FBA Surcharge Exemption

PUT 

/api/v2/product-lifecycle/fba-exemption/:product

Overrides whether a product is exempt from Amazon's 181-270-day aged-inventory surcharge bands, which changes its FBA surcharge clock. By default the exemption follows the product's Amazon product type; send null to go back to that.

Required scope: products:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Body:

  • exempt (required, boolean or null): true = exempt, false = not exempt, null = clear the override and use the Amazon product type

Response fields: product_id, exempt_override (the value you sent), fba_clock (the recalculated clock, or null when the product has no FBA stock).

fba_clock fields (null when the product has no FBA stock): product_id, fba_units, exempt (exempt from the 181-270-day surcharge bands), exemption_source (override, product_type, or null), product_types (Amazon product types behind the exemption), next_band_days (age in days at which the next band starts), next_band_date, days_until_next_band, next_band_units (units that will cross it), next_band_monthly_cost, current_monthly_cost, removal_deadline (last day a removal order avoids the next band - Amazon assesses on the 15th, so this is the 14th), label (human-readable summary).

Returns 422 when exempt is missing or not a boolean, and 404 when the product does not exist.

Requires a Bearer token with the products read/write scope and the products.manage_lifecycle permission.

Request​

Responses​

OK

Response Headers
    Content-Type