HomeDocumentationCode SamplesAPI ReferenceAnnouncementsModelsRelease NotesFAQGitHubVideos
Developer HubAPI StatusSupport
Announcements
Developer HubAPI StatusSupport
Back to All

Update to Fulfillment Inbound API v2024-03-20

November 3rd, 2025 by JackE_Amazon

Effective October 17, 2025, updates have been made to the Fulfillment Inbound API v2024-03-20 to improve shipment placement efficiency.

Background / What’s Unchanged

  • The Fulfillment Inbound API (v2024-03-20) continues to support generating multiple placement options for a single inbound plan using generatePlacementOptions and retrieving them via listPlacementOptions.
  • The workflow for generating transportation options (generateTransportationOptions → listTransportationOptions) and confirming the final selection with confirmPlacementOption remains the same.
  • The API continues to surface both placement and transportation options that align with the selected shipping mode (for example, small-parcel (SPD), less-than-truckload (LTL), or full truckload (FTL)).
  • Sellers and integrators can continue calling getShipment to retrieve shipment-level information, including destination details and routing instructions.
  • Overall, the sequence of API calls and response structure remain consistent with previous behavior. This update focuses on improving the alignment between placement and transportation logic.

What’s Changing

  1. Transportation options are scoped in alignment with each placement option, meaning that each placement option can be used to generate only those carrier or ship-mode combinations that support that placement option.
  2. To ensure full visibility into all available transportation modes, developers should:
    1. Use generatePlacementOptions → listPlacementOptions to retrieve all available placement options.
    2. For each placement option, call generateTransportationOptions → listTransportationOptions to view its associated transportation modes.

Who Is Affected?

Developers integrating the Fulfillment Inbound API (v2024-03-20) for small-parcel (SPD) shipments. There is no change to LTL or FTL shipments.

Developer Guidance

If calling Placement operations first,

  1. Call generatePlacementOptions followed by listPlacementOptions to retrieve all available placement options for a shipment.
  2. For each placement option, call generateTransportationOptions followed by listTransportationOptions to list the eligible transportation modes.
  3. Review all placement options to confirm visibility into every carrier and ship-mode combination.
  4. If an explicit destination address is required, choose a transportation option that includes the non-Partnered Carrier mode.
  5. Finalize the selection using confirmPlacementOption once the desired placement and transportation pairing has been determined.

If No Action Is Taken

If integrations retrieve transportation options for only one placement option, you may not see all eligible carriers and could experience limited visibility during shipment creation.

For more information

Contact Developer Support for further assistance.

Refer to the Fulfillment Inbound API FAQ for more information on features that are supported with the general availability launch.