Show Draft Inbound Plan
GET/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan
Get details of a specific draft FBA inbound plan.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
prep_details_snapshot (object|null): the last successful Amazon prep-details fetch persisted on the plan — {details: [{msku, prepCategory, prepTypes[], labelOwnerConstraint, prepOwnerConstraint, allOwnersConstraint}], invalid_mskus: [msku], fetched_at: ISO8601}. Lets the Configuration page render prep requirements after a reload without re-hitting Amazon; refreshed on every successful list-prep-details call.
source_editable (boolean) — whether the ship-from may still change: the draft is unsubmitted AND ships from a supplier warehouse. The wizard's source step mirrors it; PUT …/draft-inbound-plans/{id} with source_warehouse_id enforces it.
ship_from_change — whether the ship-from can still move on Amazon for a submitted plan: changeable, mode (per_shipment once placement is confirmed, resubmit before — the plan is created again with the new address and the previous one voided), blocker (unsubmitted, warehouse_source, plan_inactive, carriers_confirmed, shipped), blocker_message, same_supplier_only (purchase orders already pin the supplier), supplier_id, shipment_count, packing_option_confirmed, box_count. See POST …/change-ship-from.
items[].product.fba_prep_instructions (string|null): the product's own FBA Prep Instructions (Products → Shipping), e.g. "Bubblewrap, FNSKU Label" — the merchant's additional prep on top of whatever Amazon's prep requirements say. Surfaced on every inbound step, the 3PL portal, the prep & pack sheet and the packing list.
Returns 404 when the inbound plan (or a shipment, box, option or item nested under it) in the path belongs to a different Amazon account than the one in the URL.
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.