--- title: "Defer Shipments" method: PUT path: "/v4/shipments/defer" tags: ["Shipments"] --- # Defer Shipments `PUT /v4/shipments/defer` Postpone the processing or delivery of specific shipments. With this endpoint, you can specify which shipments you would like to defer and provide new shipment dates, streamlining the logistics workflow when shipments cannot proceed as planned due to issues, such as delays, scheduling conflicts, or customer requests.

Before deferring a shipment, bear in mind the following:

• The shipment can be deferred by a maximum of 28 days from the date of the request.
• The shipment can only be deferred before it has been manifested.
• The maximum allowable defer requests per call is 99. ## Request body - DeferShipmentRequest[] - `ShipmentId` string, required — A unique identifier for the shipment that is being deferred. This ID is necessary to specify which shipment the new deferred status applies to, ensuring precise handling of the request. - `ShipmentDate` string, date, required — A new date assigned to the shipment indicating when it is now scheduled to be manifested and shipped (handed over to the carrier). This field allows users to adjust their shipping timelines and effectively manage their logistics according to updated requirements or circumstances.

Before entering the new shipment date, keep in mind the following:
• The date must be in the YYYY-MM-DD format.
• The date must not be in the past and cannot be more than 28 days in the future. ## Response `200` All shipments were deferred successfully. ## Other responses - `400` — Invalid request response. - `401` — Unauthorized - `403` — Forbidden - `500` — Internal Server Error --- [API](https://skmtc.dev/proshipping/apis/pro-shipping-core-api.md) · [All operations](https://skmtc.dev/proshipping/apis/pro-shipping-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/proshipping/pro-shipping-core-api/revisions/ae5fc5e90109/schema)