---
title: "Add additional stops to a shipment"
method: POST
path: "/stops/add"
tags: ["Stops", "Shipper"]
---

# Add additional stops to a shipment

`POST /stops/add`

`shipmentReference` and at least one new stop are required. Each new stop must include `address`, `action`, `name`, `sequence`, `windowStart`, `windowEnd`, and other fields dependent on the type of shipment.
For US-based clients, the address must include street address, city, state, and zipcode. The `action` is either "pickup" or "delivery". The sequence number is sequence of the stop within the shipment. The `name` of the stop is the location name. `windowStart` is when the pickup/delivery window starts for that stop. `windowEnd` is when the pickup/delivery window ends for that stop.
If the shipment is shorthaul, the new stop must include load data and it must be indicated whether the cargo is a full truckload or not. If the shipment is drayage, the new stop must indicate whether the container is empty or not and location must be included.

## Request body

- AddStopRequest
  - `shipmentReference` string, required
  - `newStops` object[], required
    - `sequence` number, required
    - `address` string, required
    - `action` string, required
    - `name` string, required
    - `windowStart` string, required
    - `windowEnd` string, required
    - `fullTruckload` boolean
    - `isEmptyContainer` boolean
    - `loads` object[]
      - `type` string
      - `quantity` number
      - `width` number
      - `length` number

## Response `200`

Status Code 200:  Successful Response - the request was successful!

- AddStopResponse
  - `success` boolean
  - `shipment` object
    - `market` object
      - `name` string
      - `code` string
    - `_id` string
    - `shipment_id` string
    - `stops` object[]
      - `_id` string
      - `action` string
      - `full_truckload` boolean
      - `location` object[]
        - `id` string
        - `address` string
        - `street` string
        - `suite_or_apt` string
        - `zipcode` string
        - `city` string
        - `state` string
        - `lng` number
        - `lat` number
      - `status` string
      - `shipment_type` string
      - `sequence` number
      - `window_start` string
      - `window_end` string

## Other responses

- `400` — Status Code 400: Bad Request Response - the request header and/or body is invalid
- `500` — Status Code 500: Internal Server Error Response - there's a problem with the Public API service

---

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