Get Product Warehouse Transfer Lines
GET/api/v2/products/:product/warehouse-transfer-lines
Get every warehouse transfer line for a product with a breakdown of where the stock physically is: ordered (net of cancellation), shipped, received, in transit (shipped but not yet received) and awaiting shipment (ordered but not yet dispatched).
products:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
Each line carries a buckets array naming the states it is in:
in_transit— open transfer, shipped units not yet receivedawaiting_shipment— open transfer, units not yet dispatchedreceived— anything received, whatever the transfer's status
A partially shipped line is in both in-flight buckets. Closed transfers never count as in transit or awaiting shipment. Lines in no bucket are omitted.
For Amazon FBA/AWD destinations, quantity_received is Amazon's confirmed receipt and quantity_in_transit is shipped minus that; a shipment Amazon has not acknowledged yet is entirely in transit.
quantity_unreceived is the open balance (ordered net of cancellation minus received). It includes units that have not shipped, so it is not an in-transit figure; it is retained for compatibility — read quantity_in_transit and quantity_unshipped instead.
Each row is one transfer LINE, identified by line_id — a transfer can carry more than one line for the same product. Results are ordered newest transfer first.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.