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": {
      "address1": "100 Nowhere Blvd",
      "address2": "Suite 100",
      "city": "Gotham City",
      "company_name": "Wayne Enterprises",
      "country": "US",
      "state": "NJ",
      "zip_code": "07093"
    },
    "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

shipmentIdstringRequiredformat: "int32"

The shipment id to get

orderIdstringRequiredformat: "int32"

The order ID the shipment belongs to

Response

Success

actual_fulfillment_datedatetime or nullOptional

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_datedatetimeOptional

Date this shipment was created

delivery_datedatetime or nullOptional

The datetime of Shipment delivered to customer.

estimated_fulfillment_datedatetime or nullOptional

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

estimated_fulfillment_date_statusenumOptional

gift_messagestring or nullOptional<=500 characters

Gift message associated with the shipment

idintegerOptional

Unique id of the shipment

insurance_valuedouble or nullOptional

Monetary amount that this shipment was insured for

invoice_amountdouble or nullOptional

Monetary amount that was invoiced for this shipment

invoice_currency_codestring or nullOptional

is_tracking_uploadedbooleanOptional

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

last_tracking_update_atdatetime or nullOptional

Timestamp for the last time this shipment had a tracking update

last_update_atdatetime or nullOptional

Date this shipment was last updated

locationobjectOptional

Information about a fulfillment center that a shipment can belong to

measurementsobjectOptional

Measurements of a shipment

order_idintegerOptional

Id of the order this shipment belongs to

package_material_typeenumOptional

parent_cartonslist of objects or nullOptional

Carton information for this shipment

productslist of objects or nullOptional

Information about the products contained in this shipment

recipientobjectOptional

Information about the recipient of a shipment

reference_idstring or nullOptional

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

require_signaturebooleanOptional

If a shipment requires signature

ship_optionstring or nullOptional

Name of the shipping option used for this shipment

statusenumOptional

status_detailslist of objects or nullOptional

Additional details about the shipment status

trackingobjectOptional

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://api.shipbob.com/2026-07/order/orderId/shipment/shipmentId:cancel \
>	-H "Authorization: Bearer <token>"

Authentication

Path parameters

Headers

Response

Errors