> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beachdepository.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel Inbound Shipment

> Cancel an inbound shipment before it reaches the vault

Cancels an inbound shipment. Only shipments in `pending` or `in_transit` status can be cancelled — once a shipment is received at the vault it can no longer be cancelled.

**Permission:** `inbound_shipments:update`

## Path parameters

<ParamField path="id" type="string" required>
  The inbound shipment ID
</ParamField>

## Request body

<ParamField body="reason" type="string">
  Optional free-text reason for the cancellation.
</ParamField>

## Response

Returns the cancelled inbound shipment.

```json theme={null}
{
  "data": {
    "id": "jn7shipin123",
    "fboAccountId": "m97fbo456",
    "organizationId": "k57orgxyz",
    "status": "cancelled",
    "shipmentNotes": "10x 1oz Gold Eagles",
    "trackingNumber": "1Z999AA10123456784",
    "carrier": "UPS",
    "createdAt": "2025-04-05T16:00:00Z"
  }
}
```