Skip to main content

List Fulfillment Centers (Across Instances)

GET 
/api/amazon/unified/fulfillment-centers

Distinct fulfillment centers across all five FC-bearing sources (storage fees, ledger, customer returns, shipments, inbound shipments). A fulfillment center is a virtual entity keyed by (integration instance, normalized FC code); every aggregate is computed in a single derived query, so the list is fully sortable and filterable on any aggregate column.

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Each row carries: per-source counts (storage_fee_rows, ledger_events, customer_returns, shipments, inbound_shipments), total estimated storage fee (storage_fee_total), current on-hand units (inventory_quantity) and their approximate value at weighted-average cost (inventory_value), derived country (display only — not sortable/filterable), and last_activity (max created_at across sources).

Filters: filter[search] / filter[code.*] on the FC code; filter[integration_instance_ids] (comma-separated); numeric advanced filters on storage_fee_rows, storage_fee_total, ledger_events, customer_returns, shipments, inbound_shipments, inventory_quantity, inventory_value (operators: is, is_not, is_one_of, greater_than, less_than, greater_than_or_equal, less_than_or_equal, between, is_empty, is_not_empty); datetime filter on last_activity (before, after, on_or_before, on_or_after, between, today, past_week, past_month, past_year, ...).

Sort (sort=, prefix - for DESC). Allowed sorts: code, integration_instance_id, storage_fee_rows, storage_fee_total, ledger_events, customer_returns, shipments, inbound_shipments, inventory_quantity, inventory_value, last_activity. Default: code ASC.

Paginated (per_page default 10). Requires Bearer token.

Request​

Responses​

OK

Response Headers
    Content-Type