Skip to main content

List Placement Options

GET 
/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/placement-options

List the placement options generated for the draft FBA inbound plan, including each option's preview shipments (the shipment split Amazon would create if that option is confirmed).

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Each option includes:

  • status — one of offered, confirmed, expired (lowercase)
  • fees / discounts — Amazon-quoted placement fees and incentives for the option
  • expiration — when the offered option expires on Amazon's side
  • shipment_ids — the Amazon shipment ids making up the option's split
  • shipments[] — preview shipments with destination_fc, destination_address, and amazon_status

Use this to compare splits (fee vs. number of destinations) before confirming one with Confirm Placement Option — confirmation is irreversible.

Run Generate Placement Options first; this endpoint reads the locally persisted results.

Each shipment includes distance_miles (integer|null): the great-circle distance in miles from the plan origin (source warehouse) to that fulfillment center, computed from internal zip coordinates. Null when a zip cannot be geocoded.

Request​

Responses​

OK

Response Headers
    Content-Type