List Pull-Stock Donors
GET/api/v2/inventory-allocations/pull-stock-donors
Lists the sales order lines a backordered line can pull on-hand stock from. Returns other sales orders holding soft allocations (allocated, not yet committed to a printed shipping label) of the same product in the same warehouse pool, excluding the backordered line's own sales order.
Each donor entry reports movable_quantity (soft on-hand that can be pulled) and priority (lower number = higher priority), ordered least-urgent first so the safest donors appear at the top.
Query:
destination_sales_order_line_id(required, integer) — the backordered sales order line that would receive the stock.
Returns an empty list when no other order in the pool holds soft-allocated stock.
Request
Responses
- 200
- 401
- 403
- 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.
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.