Bill Payments8

Bills11

Carrier Contacts5

Carrier Factors6

Carrier Payment Methods5

Carriers8

Companies5

Credit Memos8

Customer Contacts5

Customers8

Documents20

Invoices11

Loads13

Location Contacts5

Locations6

Payment Terms5

Payments6

Quotes6

Reference Data3

Saved Searches5

Search1

Services5

Shipments16

Stops5

Teams5

Users6

Vendor Contacts5

Vendor Payment Methods5

Vendors8

Webhooks

Event Notifications1

Loads

Add an additional load

Changed on Oct 16, 2026

Add an additional load to an existing shipment. This endpoint requires a shipment — it cannot create one. Creating a shipment already creates its first load structure; use this endpoint only for multi-load scenarios (extra legs, split moves).

What happens

Load is created for the specified shipment
Optionally assigns an initial carrier

To book a carrier on a load afterwards, use the load-carrier endpoints — that is the primary booking flow.

post/loads

Request

Base URL: https://api.mvmnt.io/v1
URL: https://api.mvmnt.io/v1/loads
Auth: HTTP bearer

Request body

shipmentIdstring uuid required

Parent shipment ID

Response

Load created successfully

idstring uuid required

friendlyIdstring

Human-readable load ID (e.g., "LD-12345")

keystring nullable

Client-defined reference identifier for this load

shipmentIdstring uuid

Parent shipment

shipmentKeystring nullable

Parent shipment human-readable ID (friendlyId)

Transportation mode. Optional on write — a shipment or load created without one is stored with no mode, the same as one created in the TMS.

FTL: Full Truckload — the value the TMS stores and always returns
TL: legacy spelling of FTL, still accepted on write, never returned
LTL: Less than Truckload
PTL: Partial Truckload
RLTL: Retail LTL
BULK: Bulk truckload freight
AUTO: Auto transport
EXPEDITED_AIR: Expedited air
EXPEDITED_GROUND: Expedited ground
AIR: Air freight
OCEAN: Ocean freight
RAIL: Rail freight
INTERMODAL: Intermodal (multiple modes)
DRAYAGE: Drayage/cartage

Current status of the load.

Pre-transit:

SOURCING: Looking for carrier
SELECTED: Carrier selected
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
ARRIVED_AT_DELIVERY_TERMINAL: Arrived at delivery terminal
OUT_FOR_DELIVERY: Out for delivery
RECOVERED: Recovered after a service issue

Delivered (accounts payable lifecycle):

DELIVERED_AWAITING_INVOICE: Delivered, awaiting carrier invoice
DELIVERED_INVOICE_IN_REVIEW: Carrier invoice in review
DELIVERED_APPROVED_TO_BE_PAID: Approved to be paid
DELIVERED_PAID: Paid

Final / exceptions:

COMPLETE: Complete
SERVICE_FAILURE: Service failure
ON_HOLD: On hold
CANCELED: Canceled

totalCostnumber nullable

Total carrier costs

createdAtstring date-time required

updatedAtstring date-time nullable

pickedUpAtstring date-time nullable

deliveredAtstring date-time nullable

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "friendlyId": "LD-12345",
  "key": "my-load-001",
  "stops": [
    {
      "address": {
        "line1": "123 Main St",
        "line2": "Suite 400",
        "city": "Chicago",
        "state": "IL",
        "zipCode": "60601",
        "country": "USA",
        "market": "CHI",
        "latitude": "41.8781",
        "longitude": "-87.6298",
        "isSmartyValidated": true,
        "obeysDst": true
      }
    }
  ],
  "carriers": [
    {
      "carrier": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "key": "ERP-CARRIER-SWIFT",
        "name": "Swift Transportation",
        "phoneNumber": "+1-555-987-6543",
        "email": "dispatch@swifttrans.com",
        "createdAt": "2025-01-15T10:00:00Z",
        "updatedAt": "2025-01-15T14:30:00Z"
      }
    }
  ]
}

Changes

Oct 16, 2026a67a66657930 Revision changes
- breaking
  added the new required request property ////
- breaking
  added the new required request property ////
- warning
  the //// request property's maxLength was set to 500
- warning
  the //// request property's min was set to 0.00
- warning
  removed the request property ////
- warning
  removed the request property ////
- info
  added the new optional request property ////
Oct 7, 20262cd6ecfbeb82 Revision changes
- breaking
  the response's body type changed from object to no type for status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- warning
  added the new DROP enum value to the // response property for the response status
- warning
  added the new PICK enum value to the // response property for the response status
- info
  added subschema #2 to the response body allOf list for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  removed the DELIVERY enum value from the // response property for the response status
- info
  removed the PICKUP enum value from the // response property for the response status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history (7 revisions)