Cancel Shipment by Order ID and Shipment ID

{
  "actual_fulfillment_date": "2019-08-24T14:15:22+00:00",
  "created_date": "2019-08-24T14:15:22+00:00",
  "delivery_date": "2019-08-24T14:15:22+00:00",
  "estimated_fulfillment_date": "2019-08-24T14:15:22+00:00",
  "estimated_fulfillment_date_status": "AwaitingInventoryAllocation",
  "gift_message": "string",
  "id": 0,
  "insurance_value": 0,
  "invoice_amount": 0,
  "invoice_currency_code": "string",
  "is_tracking_uploaded": true,
  "last_tracking_update_at": "2019-08-24T14:15:22+00:00",
  "last_update_at": "2019-08-24T14:15:22+00:00",
  "location": {
    "id": 0,
    "name": "Cicero (IL)"
  },
  "measurements": {
    "depth_in": 0,
    "length_in": 0,
    "total_weight_oz": 0,
    "width_in": 0
  },
  "order_id": 0,
  "package_material_type": "Unknown",
  "parent_cartons": [
    {
      "barcode": "string",
      "cartons": [
        {
          "barcode": "string",
          "carton_details": [
            {
              "products": [
                {
                  "id": 0,
                  "inventory_items": [
                    {
                      "expiration_date": "2019-08-24T14:15:22+00:00",
                      "id": 0,
                      "is_dangerous_goods": true,
                      "lot": "22222",
                      "name": "Medium Blue T-Shirt",
                      "quantity": 0,
                      "quantity_committed": 0,
                      "serial_numbers": [
                        "string"
                      ]
                    }
                  ],
                  "name": "Medium Blue T-Shirt",
                  "reference_id": "TShirtBlueM",
                  "sku": "TShirtBlueM"
                }
              ]
            }
          ],
          "id": 0,
          "measurements": {
            "depth_in": 0.1,
            "length_in": 0.1,
            "total_weight_oz": 0.1,
            "width_in": 0.1
          },
          "type": "Box or pallet"
        }
      ],
      "measurements": {
        "depth_in": 0.1,
        "length_in": 0.1,
        "total_weight_oz": 0.1,
        "width_in": 0.1
      },
      "type": "Box or pallet"
    }
  ],
  "products": [
    {
      "id": 0,
      "inventory_items": [
        {
          "expiration_date": "2019-08-24T14:15:22+00:00",
          "id": 0,
          "is_dangerous_goods": true,
          "lot": "22222",
          "name": "Medium Blue T-Shirt",
          "quantity": 0,
          "quantity_committed": 0,
          "serial_numbers": [
            "string"
          ]
        }
      ],
      "name": "Medium Blue T-Shirt",
      "reference_id": "TShirtBlueM",
      "sku": "TShirtBlueM"
    }
  ],
  "recipient": {
    "address": null,
    "email": "john@example.com",
    "full_name": "John Doe",
    "name": "John Doe",
    "phone_number": "555-555-5555"
  },
  "reference_id": "string",
  "require_signature": true,
  "ship_option": "Standard",
  "status": "None",
  "status_details": [
    {
      "description": "string",
      "exception_fulfillment_center_id": 0,
      "extra_information": {
        "validation_messages": [
          "string"
        ]
      },
      "id": 0,
      "inventory_id": 0,
      "name": "string"
    }
  ],
  "tracking": {
    "bol": "string",
    "carrier": "USPS",
    "carrier_service": "Priority",
    "pro_number": "string",
    "scac": "string",
    "shipping_date": "2019-08-24T14:15:22+00:00",
    "tracking_number": "860C8CDC8F0B4FC7AB69AC86C20539EC",
    "tracking_url": "https://www.example.com/tracking?id=860C8CDC8F0B4FC7AB69AC86C20539EC"
  }
}

Cancels a specific shipment by order ID and shipment ID. The shipment must not be picked, packed, or shipped to proceed with the cancellation.

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

AuthorizationBearer

OAuth2 authentication using JWT tokens

Path parameters

shipmentIdintegerRequired

The shipment id to get

orderIdintegerRequired

The order ID the shipment belongs to

Response

Success

actual_fulfillment_datedatetime

The datetime of ShipBob’s completion of the fulfillment operation as promised. Currently, this means the shipment has been picked, packed, and label has been printed.

created_datedatetime

Date this shipment was created

delivery_datedatetime

The datetime of Shipment delivered to customer.

estimated_fulfillment_datedatetime

The datetime of ShipBob’s commitment for completing the shipment and handing to the carrier for delivery.

estimated_fulfillment_date_statusenum

gift_messagestring<=500 characters

Gift message associated with the shipment

idinteger

Unique id of the shipment

insurance_valuedouble

Monetary amount that this shipment was insured for

invoice_amountdouble

Monetary amount that was invoiced for this shipment

invoice_currency_codestring

is_tracking_uploadedboolean

Indicates whether the Shipment was marked with tracking information uploaded to a third-party system where the order originated.

last_tracking_update_atdatetime

Timestamp for the last time this shipment had a tracking update

last_update_atdatetime

Date this shipment was last updated

locationobject

Information about a fulfillment center that a shipment can belong to

measurementsobject

Measurements of a shipment

order_idinteger

Id of the order this shipment belongs to

package_material_typeenum

parent_cartonslist of objects

Carton information for this shipment

productslist of objects

Information about the products contained in this shipment

recipientobject

Information about the recipient of a shipment

reference_idstring

Client-defined external unique id of the order this shipment belongs to

require_signatureboolean

If a shipment requires signature

ship_optionstring

Name of the shipping option used for this shipment

statusenum

status_detailslist of objects

Additional details about the shipment status

trackingobject

Tracking information for a shipment

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

$	curl -X POST https://sandbox-api.shipbob.com/2026-01/order/1/shipment/1:cancel \
>	-H "Authorization: Bearer <token>"

Authentication

Path parameters

Headers

Response

Errors