Orders & FulfillmentOrders & FulfillmentOrders

Update the in-transit shipment status of an order

Records a non-terminal shipment-lifecycle event for an order (ready for pickup, picked up, in transit, out for delivery). Use the dedicated /deliver endpoint for terminal delivery — it carries proof-of-delivery semantics this endpoint does not.

Amazon SP-API Orders v0 updateShipmentStatus parity.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

purchaseOrderIdstringRequired

Request

This endpoint expects an object.
shipmentStatusenumRequired

Non-terminal shipment-lifecycle state. Mirrors Amazon SP-API Orders v0 shipmentStatus. For terminal Delivered use the dedicated /deliver endpoint.

orderLineslist of objectsRequired
statusDatedatetimeOptional

ISO-8601 timestamp at which the seller observed the status change. Optional — if omitted, FMS defaults to server time.

Response

Success
purchaseOrderIdstringOptional
shipmentStatusenumOptional
updatedAtdatetimeOptional

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error