Skip to main content

List FBA Minimums

GET 
/api/amazon/:integrationInstance/fba-stock-floors

Paginated FBA minimum stock levels of one Amazon account, one row per product × FBA region. A pair is listed when it has its own floor or has been evaluated, so after the first sweep (every 15 min) every mapped product of every region appears, with status no_floor when nothing applies.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

Row fields: settings (floor_mode, min_units, min_days_of_cover, include_inbound, ignore_inbound_after_days, alerts_enabled) are the EFFECTIVE values after inheritance from the region default; inherited lists the fields the product left to the region default and own carries the raw stored values (null = unset). source is product | region_default | none. route is the route that restocks the pair with its effective lead time (lead_source manual | measured | default); primary_route is the region's primary route (is_fallback true when none was chosen). State fields (velocity_per_day, counted, days_of_cover, status, below_since, alerted_at, data_as_of) come from the last evaluation and are null before the first sweep; a units floor reports effective_floor_units before that, a days-of-cover floor only after. status is ok | recovering | below | out | no_floor | no_demand | pending | stale | unmapped; stale (the account's FBA inventory data is too old to evaluate) applies only to a pair that has a floor — a pair with no floor reports no_floor. suggested_send_qty and create_plan_url are set for below/out pairs.

Filters: region_code, status, search, has_floor, product_id — each accepted as filter[key] or as a top-level key.

Allowed sorts (prefix with - for descending): sku (default), product_name, region_code, status, effective_floor_units, days_of_cover, counted_total.

Pagination: page (default 1), per_page (default 10, max 500).

Requires the fba_stock_floors.view permission.

Authentication: Bearer token.

Request​

Responses​

OK

Response Headers
    Content-Type