---
title: "Shipping - Void"
method: DELETE
path: "/s/ship/shipping/void"
tags: ["shipping"]
---

# Shipping - Void

`DELETE /s/ship/shipping/void`

Void a shipment, cancelling the shipping label and optionally restoring inventory.

## Request body

- object
  - `store_id` string, required — Store ID
  - `order_number` string, required — Order number
  - `shipment_id` string — SKULabs shipment ID
  - `tracking_number` string — Tracking number to identify the shipment
  - `no_refresh` boolean — Skip cache refresh after voiding
  - `carrier_shipment_id` string — Carrier-specific shipment ID
  - `force_void` boolean — Force void even if carrier void fails

## Response `200`

Shipment voided and inventory restored (returns updated order shipments)

- object
  - `_id` string — Order ID
  - `shipments` ShipmentResult[] — Order shipments
    - `_id` string — Shipment ID
    - `request` ShipRequest — Original shipment request
      - `_id` string — Shipment request ID
      - `store_id` string — Store ID
      - `parcel` Parcel, required — Package dimensions and weight
        - `length` number — Package length
        - `width` number — Package width
        - `height` number — Package height
        - `weight` number — Package weight (ounces by default)
        - `weight_unit` 'oz' | 'lb' | 'g' | 'kg' — Weight unit
        - `dimensions_unit` 'in' | 'cm' — Dimensions unit
        - `template` string — Predefined package template name
        - `template_carrier` string — Carrier type for the template
      - `address` ShippingAddress, required — Destination address
        - `name` string — Recipient or sender name
        - `company` string — Company name
        - `street` string — Street address line 1
        - `street_2` string — Street address line 2
        - `city` string — City
        - `state` string — State or province code
        - `zip` string — Postal or ZIP code
        - `country` string — Two-letter country code
        - `phone` string — Phone number
        - `email` string — Email address
        - `residential` boolean, nullable — Whether the address is residential
      - `origin_address` object — Origin/ship-from address
        - `name` string — Recipient or sender name
        - `company` string — Company name
        - `street` string — Street address line 1
        - `street_2` string — Street address line 2
        - `city` string — City
        - `state` string — State or province code
        - `zip` string — Postal or ZIP code
        - `country` string — Two-letter country code
        - `phone` string — Phone number
        - `email` string — Email address
        - `residential` boolean, nullable — Whether the address is residential
      - `return_address` object — Return address
        - `name` string — Recipient or sender name
        - `company` string — Company name
        - `street` string — Street address line 1
        - `street_2` string — Street address line 2
        - `city` string — City
        - `state` string — State or province code
        - `zip` string — Postal or ZIP code
        - `country` string — Two-letter country code
        - `phone` string — Phone number
        - `email` string — Email address
        - `residential` boolean, nullable — Whether the address is residential
      - `rate` object — Selected rate/service
        - `service` string — Selected service name
        - `service_code` string — Selected service code (use "cheapest" for cheapest rate)
        - `carrier_account` object — Carrier account for this rate
          - `_id` string — Carrier account ID
          - `name` string — Carrier account name
      - `carrier_account_ids` string[] — Carrier account IDs to consider
      - `order_items` object[] — Items to include in this shipment
        - `sku` string — Item SKU
        - `item_id` string — Item ID
        - `quantity` number — Quantity to ship
        - `location_id` string — Inventory location ID
      - `customs_items` CustomsItem[] — Customs declaration items for international shipments
        - `description` string — Item description for customs
        - `quantity` number — Item quantity
        - `value` number — Item value per unit
        - `weight` number — Item weight
        - `hs_tariff_number` string — Harmonized System tariff number
        - `origin_country` string — Country of origin
      - `signature_confirmation` boolean — Request signature confirmation
      - `insurance_amount` number — Insurance coverage amount
      - `insurance_type` string — Insurance type (direct or default)
      - `return_label` boolean — Generate a return label instead of outbound
      - `reference_1` string — Reference field 1
      - `reference_2` string — Reference field 2
      - `format` string — Label format (e.g. paper for laser printer)
      - `currency` string — Currency code
      - `origin` string — Warehouse ID for origin
      - `shipping_date` string — Requested shipping date (ISO 8601)
      - `should_deduct` boolean — Whether to deduct inventory on shipment
    - `response` object — Carrier response
      - `provider` string — Shipping provider
      - `service` string — Service used
      - `tracking_number` string — Tracking number
      - `shipment_id` string — Carrier shipment ID
      - `amount` number — Postage cost
      - `label_url` string — URL to download the shipping label
      - `fees` number — Additional carrier fees
    - `time` string — Shipment creation time
    - `state` 'shipped' | 'failed' | 'voided' — Shipment state
    - `manual_shipment` boolean — Whether this was a manual shipment
    - `deducted` boolean — Whether inventory was deducted

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden. Insufficient permissions.
- `429` — Too many requests. Rate limit exceeded.
- `500` — Internal server error.

---

[API](https://skmtc.net/skulabs/apis/skulabs-api.md) · [All operations](https://skmtc.net/skulabs/apis/skulabs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skulabs/skulabs-api/revisions/4b5ec0ed78a6/schema)