Get Send Plan Product Detail
GET/api/send-plans/:sendPlan/products/:product
Everything the plan knows about one product: its source pool (row), every network line with its source lanes, step-by-step explanation and events (the audit trail of overrides, resets, resolutions and carry-forwards: event, from/to quantity, reason, note, user and time), the plan's source warehouses, incoming supply at those warehouses (open purchase and manufacturing orders, with the nearest ETA in days), and whether the product is a kit or manufactured — useful for deciding how to close a shortfall.
send-plans:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Bearer Personal Access Token with the send-plans:read scope. The token's user also needs permission to view the send planner.
incoming[].ref_type identifies the kind of supply document (purchase order or manufacturing order) and ref_id its ID.
lines[].events[].user_name is the name of the user behind each event (null for system events).
production (manufactured products and kits only; null otherwise): what Plan Production for Send Plan Product would put on the Master Production Schedule — quantity (the shortfall), need_by (Y-m-d) with need_by_reason, the suggested warehouse_id and the plan's source warehouse_options, send_plan_line_id (the most-short line), and existing (production demand the planner already raised for this product: id, warehouse_id, warehouse_name, bucket_start, quantity, send_plan_id, send_plan_line_id). When the product is not short but demand was raised earlier, quantity is 0 and only existing is filled.
Returns 404 when the product is not in the plan.
Request
Responses
- 200
- 401
- 403
- 404
- 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
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.