Create or update load

​
Body·
required
application/json
  • brokerage
    Type: object ·
    required
  • load
    Type: object ·
    required
  • carrier
    Type: object ·
  • carrierPaymentStatuses
    Type: array object[] ·

    Per-carrier payment status entries for this load. Each entry represents the payment outcome for one carrier on the load (e.g., TONU + linehaul on a co-brokered load yields two entries). Sending this field replaces any prior set of statuses for the load.

  • customer
    Type: object ·
  • trackingEvents
    Type: array object[] ·

    Providing this field replaces all existing tracking events for the Load, including an empty array, which clears them. Omit the field to preserve existing tracking events. To append events instead of replacing them, use the POST /v2/loads/tracking endpoint.

Responses
  • 204

    Load created successfully

  • 400

    Bad request (work in progress)

Request Example for post/v2/loads
curl https://api.prod.goaugment.com/v2/loads \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Basic username:password' \
  --data '{
  "brokerage": {},
  "load": {
    "loadNumber": "1",
    "mode": "FTL",
    "status": "DRAFT",
    "isPostedToDAT": false,
    "route": [
      {
        "sequence": 1,
        "stopActivity": "PICKUP",
        "expectedArrivalWindowStart": "2025-09-01T12:00:00Z",
        "expectedArrivalWindowEnd": "2025-09-01T14:00:00Z",
        "address": {
          "street1": "1 Santa Monica Blvd",
          "city": "Santa Monica",
          "stateOrProvince": "CA",
          "postalCode": "90401",
          "country": "US"
        }
      },
      {
        "sequence": 2,
        "stopActivity": "DELIVERY",
        "expectedArrivalWindowStart": "2025-09-02T12:00:00Z",
        "expectedArrivalWindowEnd": "2025-09-02T14:00:00Z",
        "address": {
          "street1": "1 Market St",
          "city": "San Francisco",
          "stateOrProvince": "CA",
          "postalCode": "94105",
          "country": "US"
        }
      }
    ],
    "items": [
      {
        "quantity": 600,
        "packagingUnit": {
          "unitType": "CARTON",
          "quantity": 60
        },
        "handlingUnit": {
          "unitType": "PALLET",
          "quantity": 3
        },
        "description": "600 pieces packed in 60 cartons on 3 pallets",
        "totalWeightLbs": 12000,
        "lengthInches": 48,
        "widthInches": 40,
        "heightInches": 60,
        "freightClass": "70",
        "nmfc": "123456"
      }
    ]
  }
}'
No Body

Load created successfully