---
title: "Update a load"
method: PATCH
path: "/loads/{id}"
tags: ["Loads"]
---

# Update a load

`PATCH /loads/{id}`

Update load fields.

**Note:** To manage carriers, use the carrier-specific endpoints.

## Path parameters

- `id` string, required

## Query parameters

- `by` 'id' | 'key'

## Request body

- LoadPatch
  - `mode` 'TL' | 'LTL' | 'AIR' | 'OCEAN' | 'RAIL' | 'INTERMODAL' | 'DRAYAGE' — Transportation mode. - `TL`: Full Truckload - `LTL`: Less than Truckload - `AIR`: Air freight - `OCEAN`: Ocean freight - `RAIL`: Rail freight - `INTERMODAL`: Intermodal (multiple modes) - `DRAYAGE`: Drayage/cartage

## Response `200`

Load updated successfully

- Load
  - `id` string, uuid, required
  - `key` string, nullable — Human-readable load ID
  - `shipmentId` string, uuid — Parent shipment
  - `shipmentKey` string, nullable — Parent shipment friendly ID
  - `mode` 'TL' | 'LTL' | 'AIR' | 'OCEAN' | 'RAIL' | 'INTERMODAL' | 'DRAYAGE' — Transportation mode. - `TL`: Full Truckload - `LTL`: Less than Truckload - `AIR`: Air freight - `OCEAN`: Ocean freight - `RAIL`: Rail freight - `INTERMODAL`: Intermodal (multiple modes) - `DRAYAGE`: Drayage/cartage
  - `status` 'SOURCING' | 'BOOKED' | 'DISPATCHED' | 'LOADING' | 'PICKED_UP' | 'IN_TRANSIT' | 'UNLOADING' | 'DELIVERED' | 'CANCELED', required — Current status of the load. **Pre-transit:** - `SOURCING`: Looking for carrier - `BOOKED`: Carrier booked - `DISPATCHED`: Dispatched to carrier **In-transit:** - `LOADING`: Loading at pickup - `PICKED_UP`: Picked up - `IN_TRANSIT`: In transit - `UNLOADING`: Unloading at delivery **Final:** - `DELIVERED`: Delivered - `CANCELED`: Canceled
  - `stops` LoadStop[] — Load stops
    - `id` string, uuid
    - `orderStopId` string, uuid — Reference to the order stop
    - `sequence` integer
    - `type` 'PICKUP' | 'DELIVERY' | 'CROSS_DOCK'
    - `address` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
      - `line1` string, required — Primary street address line
      - `line2` string, nullable — Secondary address line (suite, floor, etc.)
      - `city` string, required — City name
      - `country` string, required — Country name or code
      - `market` string, required — Market or region identifier
      - `latitude` string, nullable — Latitude coordinate
      - `longitude` string, nullable — Longitude coordinate
      - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
      - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
      - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
      - `obeysDst` boolean, required — Whether this location observes daylight saving time
      - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
    - `scheduledArrival` string, date-time, nullable
    - `actualArrival` string, date-time, nullable
    - `actualDeparture` string, date-time, nullable
  - `carriers` LoadCarrier[] — Carrier assignments (flattened from LoadCarriersConnection)
    - `id` string, uuid
    - `carrier` CarrierReference — Enhanced reference to a carrier resource (returned in responses). Includes full carrier details in addition to id/key. Note: Does NOT include nested references (contacts, etc.) to prevent recursion. Maximum nesting depth: 1 level.
      - `id` string, uuid, required — Carrier UUID
      - `key` string, nullable — Client-defined reference ID if set
      - `name` string, required — Carrier company name
      - `phoneNumber` string, nullable — Primary phone number
      - `email` string, email, nullable — Primary email address
      - `createdAt` string, date-time, required — When the carrier was created
      - `updatedAt` string, date-time, required — When the carrier was last updated
      - `deletedAt` string, date-time, nullable — When the carrier was soft deleted (null if active)
    - `contact` object
      - `id` string, uuid
      - `name` string
      - `phone` string, nullable
      - `email` string, nullable
    - `status` 'ACTIVE' | 'TONU' | 'BOUNCED' — Status of the carrier assignment. - `ACTIVE`: Carrier is actively assigned - `TONU`: Truck Ordered Not Used (carrier dispatched but cancelled) - `BOUNCED`: Carrier bounced/rejected load
    - `billingStatus` 'AWAITING_INVOICE' | 'INVOICE_IN_REVIEW' | 'APPROVED_TO_PAY' | 'PAID' — Billing status for the load (AP side). - `AWAITING_INVOICE`: Waiting for carrier invoice - `INVOICE_IN_REVIEW`: Invoice received, under review - `APPROVED_TO_PAY`: Approved for payment - `PAID`: Paid to carrier
    - `bookedAt` string, date-time, nullable
    - `dispatchedAt` string, date-time, nullable
    - `charges` LoadCarrierCharge[] — Flattened charges array
      - `id` string, uuid
      - `chargeCode` ResourceReference — Reference to another resource (returned in responses)
        - `id` string, uuid, required — Resource UUID
        - `key` string, nullable — Client-defined reference ID if set
      - `description` string, nullable
      - `amount` number
      - `quantity` number
    - `totalCost` number, nullable — Sum of all charges
    - `driverName` string, nullable
    - `driverPhone` string, nullable
    - `truckNumber` string, nullable
    - `trailerNumber` string, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time, nullable
  - `totalCost` number, nullable — Total carrier costs
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, nullable
  - `pickedUpAt` string, date-time, nullable
  - `deliveredAt` string, date-time, nullable

## Other responses

- `400` — Bad request - invalid input
- `401` — Unauthorized - invalid or missing access token
- `404` — Resource not found
- `422` — Validation error - invalid field values

---

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