List inventory transfers (warehouse, intercompany, FBA inbound)
Returns a paginated list of inventory transfer records for the entity. A transfer
is visible when EITHER endpoint matches the active location (Pattern A on
inventory_transfers.location_from_id OR location_to_id), mirroring the
bin-movements operator mental model “show me every transfer that touches LOC-X”.
Layer 4 location isolation (NEW-GAP-API-V1-LIST-X-LOCATION-ID-SWEEP, 2026-05-17):
the wrapper applies the X-Location-Id request header first, then the
location_id query param (header takes precedence). When neither is set,
the response is entity-wide (admin view). location_from_id and
location_to_id are NOT NULL in the schema, so there is no NULL-universal
carve-out for transfers.
Filter set: status, transfer_type, search (transfer_number prefix +
trigram similarity). The page also returns a stats object with rollups
for active, pending_approval, in_transit, and closed_today counts
scoped to the same location filter.
Requires inventory:read scope.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
Active location pill (Layer 4 isolation). Takes precedence over the
location_id query parameter. The wrapper enforces the precedence
ladder header > qp > admin entity-wide, matching listOrdersV1 /
listReturnsV1 / listPackagesV1 / listLabelsV1 / listSerialsV1.
Query Parameters
Filter to a single warehouse location (Layer 4). Used only when
X-Location-Id is absent. A transfer is included whenever its
location_from_id OR location_to_id matches.
Comma-separated list of location UUIDs (multi-location restriction;
user_locations gate). When supplied, supersedes both location_id
and X-Location-Id. Each transfer is included when EITHER endpoint
sits in the array.
draft, submitted, pending_approval, approved, rejected, in_transit, working, shipped, receiving, received, closed, cancelled, all internal, intercompany, fba_inbound, all Transfer number prefix match plus trigram similarity (> 0.3).
x >= 11 <= x <= 100
