---
title: "Start a Shipment"
method: PATCH
path: "/public/v3/Shipments/{shipmentId}/start"
tags: ["Shipments"]
---

# Start a Shipment

`PATCH /public/v3/Shipments/{shipmentId}/start`

Start the specified shipment.

## Path parameters

- `shipmentId` string, required

## Headers

- `x-tive-account-id` integer, required

## Request body

- ShipmentDeviceRequest
  - `skipDeviceLocationCheck` boolean — Determines whether a shipment should start even if the tracker location does not match the shipment start location. Defaults to `false`.
  - `closeActiveShipments` boolean — Close other active shipments related to the trackers being added to this shipment. When closing an existing shipment the new shipment will start at the current time. Defaults to `false`.
  - `devices` string[], nullable — A list of device IDs associated with the shipment. Note, to <emp>start</emp> a shipment you must specify at least one device.
  - `trackerStartDelay` 'ZeroMinutes' | 'ThirtyMinutes' | 'OneHour' | 'OneAndHalfHours' | 'TwoHours' | 'FourHours' — The period of time the tracker should wait before measuring or transmitting data after the start button is pressed. This is ONLY for Solo Pro Devices.

## Response `200`

The shipment has been started

## Other responses

- `400` — Unable to start the shipment. See response message for details.
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/tive/apis/tive-public-api.md) · [All operations](https://skmtc.net/tive/apis/tive-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tive/tive-public-api/versions/9a8d869e3cdc/schema)