Skip to main content

List Initial Inventory (Across Instances)

GET 
/api/amazon/unified/initial-inventory

Returns paginated FBA initial inventory rows across all Amazon integration instances. Initial inventory is the FBA warehouse balance snapshot captured at the account's inventory tracking start date, used to seed FIFO cost layers and reconcile early ledger activity.

Authorization

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

This route accepts both GET and POST with identical behavior - send the same parameters as a JSON body via POST when the filter payload is too long for a query string (e.g. a large filter_groups tree). Only this GET request is documented; do not treat POST as a separate operation.

Query parameters:

  • page (default 1), per_page (default 10).
  • sort - allowed fields: id, fnsku, asin, msku, disposition, ending_warehouse_balance, location, created_at (prefix - for descending).
  • filter[integration_instance_ids] - comma-separated instance IDs.
  • filter[search] - matches fnsku, asin, msku, title, or integration instance name.
  • Operator filters using filter[column.operator]=value syntax:
    • Text columns fnsku, asin, msku, title, disposition, location, integration_instance_name: contains, does_not_contain, is, is_not, is_one_of, is_not_one_of, starts_with, does_not_start_with, ends_with, does_not_end_with, is_empty, is_not_empty.
    • Numeric columns id, ending_warehouse_balance: is, is_not, is_one_of, is_not_one_of, greater_than, less_than, greater_than_or_equal, less_than_or_equal, between, is_empty, is_not_empty.
    • Date column created_at: is, is_not, before, after, on_or_before, on_or_after, between, is_empty, is_not_empty, today, yesterday, tomorrow, past_week, past_month, past_year, next_week, next_month, next_year.
    • A bare filter[column]=value acts as an implicit is.
  • filter_groups - base64-encoded JSON tree ({"conjunction": "and", "children": [...]}) for nested and/or filter groups; via POST it may be sent as a plain JSON object.

Each row includes the linked FNSKU product and its SKU.io product (when mapped), the initial unit cost, reconciliation state, and the FIFO layer ID created from the row.

Request​

Responses​

OK

Response Headers
    Content-Type