Load object

{
  "externalId": "<string>",
  "externalCustomerId": "<string>",
  "status": "ON_HOLD",
  "trailerRequirements": {
    "allowedTypes": [
      "REEFER"
    ],
    "powerOnlyType": "PRE_LOADED",
    "doorType": "SWING",
    "maxAgeYears": 123,
    "highCube": true,
    "spaceSaver": true,
    "suspensionType": "AIR_RIDE",
    "foodGrade": true,
    "wallType": "SHEET_AND_POST",
    "logisticPost": true,
    "eTrackRails": "VERTICAL",
    "eTracksDistance": "TWO_FEET",
    "extendable": true,
    "liftGate": true,
    "minAxles": 123,
    "metalEdgeProtectors": true,
    "airChute": true,
    "ctpatCompliant": true,
    "floorTypes": [
      "HARDWOOD"
    ]
  },
  "carrierRequirements": {
    "ctpatCertified": true,
    "oeaCertified": true,
    "pipCertified": true,
    "fastCertified": true,
    "internationalCarrierBonded": true,
    "internationalCarrierBondedUS": true,
    "internationalCarrierBondedCA": true,
    "internationalCarrierBondedMX": true,
    "has247CustomerService": true,
    "minCargoInsurance": {
      "currencyCode": "USD",
      "amount": 500000000
    }
  },
  "driverRequirements": {
    "twicCard": true,
    "tankerEndorsed": true,
    "cdl": true
  },
  "id": "<string>",
  "stops": [
    {
      "type": "PICKUP",
      "externalId": "<string>",
      "location": {
        "place": {
          "type": "ADDRESS",
          "street": "<string>",
          "city": "<string>",
          "state": "<string>",
          "countryCode": "US",
          "postalCode": "<string>",
          "neighborhood": "<string>"
        },
        "coordinates": {
          "latitude": 0,
          "longitude": 0
        },
        "isCtpatCertified": true,
        "isPipCertified": true,
        "isOeaCertified": true,
        "carrierPreapproval": "FIXED_LIST",
        "timezone": "<string>"
      },
      "appointment": {
        "type": "UNSPECIFIED"
      },
      "referenceNumbers": [
        {
          "label": "<string>",
          "value": "<string>"
        }
      ],
      "loadingMethod": "LIVE",
      "inboundTransitRequirements": {
        "maximumExpectedMinutes": 123,
        "securityEscortProvider": "PROVIDER",
        "teamDriverRequired": true,
        "trackingRequired": true
      },
      "dropDurationHours": 24,
      "fumigation": {
        "requiredBefore": true,
        "requiredAfter": true
      },
      "scaleTicket": {
        "requiredBefore": true,
        "requiredAfter": true
      },
      "driverAssistRequired": true
    }
  ],
  "externalDisplayId": "ORD-2024-001",
  "externalWorkspaceId": "<string>",
  "referenceNumbers": [
    {
      "label": "<string>",
      "value": "<string>"
    }
  ],
  "commodities": [
    {
      "name": "<string>",
      "hazmatDetails": {
        "isHazmat": true,
        "classification": "CLASS_3_FLAMMABLE_LIQUIDS",
        "unNumber": "1263",
        "packingGroup": "II"
      },
      "dimensions": {
        "length": {
          "value": 123,
          "unit": "FEET"
        },
        "width": {
          "value": 123,
          "unit": "FEET"
        },
        "height": {
          "value": 123,
          "unit": "FEET"
        }
      },
      "weight": {
        "type": "APPROXIMATE",
        "value": 123,
        "unit": "POUNDS"
      },
      "temperatureRequirements": {
        "minimum": 10,
        "maximum": 20,
        "unit": "CELSIUS"
      },
      "pieces": {
        "type": "PALLET",
        "stackable": true,
        "perPieceVolume": {
          "value": 100,
          "unit": "GALLONS"
        },
        "perPieceDimensions": {
          "length": {
            "value": 123,
            "unit": "FEET"
          },
          "width": {
            "value": 123,
            "unit": "FEET"
          },
          "height": {
            "value": 123,
            "unit": "FEET"
          }
        },
        "count": 10
      }
    }
  ],
  "requiredEquipment": [
    {
      "type": "LOAD_BARS",
      "quantity": 500.5
    }
  ],
  "metadata": {
    "tmsOrderId": "1314234",
    "customerName": "Acme Corp"
  },
  "truckload": "FULL",
  "roundTrip": true,
  "linearFeet": 123,
  "maxBuy": {
    "currencyCode": "USD",
    "amount": 500000000
  },
  "targetRate": {
    "currencyCode": "USD",
    "amount": 500000000
  }
}

A load in the Cargado system.

externalId

string

required

The unique ID for the load in your TMS. This identifier will not be displayed outside your organization. Examples: "456293", "TMS232423"

Required string length: 1 - 255

Example:

"456293"

externalCustomerId

string

required

The unique ID of your customer in your TMS. This will not be displayed outside your organization. This should not change for the lifetime of the load. Examples: "ACMECORP", "ASHIPPERCO"

Required string length: 1 - 255

Example:

"ACMECORP"

status

enum<string>

required

The status of the load.

Available options:

ON_HOLD,

AVAILABLE,

BOOKED,

CANCELLED,

COMPLETED

trailerRequirements

object

required

The trailer requirements for the load.

Show child attributes

carrierRequirements

object

required

The requirements for the carrier.

Show child attributes

driverRequirements

object

required

The requirements for the driver.

Show child attributes

string

required

The unique id for the load in the Cargado system. This is a UUID prefixed with load_.

Example:

"load_c6ee2dff-f35f-4880-b7a6-9b2a1fa1476e"

stops

object[]

required

The list of stops for the load. The first stop is the origin and the last stop is the destination.

Required array length: 2 - 64 elements

A pickup stop where goods are loaded.

Option 1
Option 2
Option 3

Show child attributes

externalDisplayId

string | null

A customizable display ID for the load. This field allows organizations to configure how their load IDs are displayed in Cargado. If not provided, the externalId will be used as the display ID. Examples: "ORD-2024-001", "SHIP-456293", "LOAD-TMS232423"

Required string length: 1 - 255

Example:

"ORD-2024-001"

externalWorkspaceId

string | null

The ID used to map your freight to team/user workspaces in Cargado. If not provided, the freight will be created in your organization's default workspace.

referenceNumbers

object[] | null

Reference numbers associated with the load.

Show child attributes

commodities

object[]

The commodities for the load. Usually required, but can be omitted for power only loads that are load-out or tow-away.

Maximum array length: 128

Show child attributes

requiredEquipment

object[] | null

A list of standalone equipment required for the load.

Show child attributes

metadata

object

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

Show child attributes

Example:

{
  "tmsOrderId": "1314234",
  "customerName": "Acme Corp"
}

truckload

enum<string>

Whether the load is full truckload or partial truckload.

Available options:

FULL,

PARTIAL

roundTrip

boolean | null

Whether the load is a round trip.

linearFeet

number<double> | null

Linear feet is the amount of floor space cargo occupies in a trailer. This is primarily relevant for partial truckload shipments. If not provided for partial loads, it will be automatically calculated based on commodity dimensions.

maxBuy

object

The maximum buy amount for the load. Typically used to inform team members of what rate they can cover the freight at without manager approval. This value is not used directly, but can be referenced when setting up posting rules.

Show child attributes

targetRate

object

The target rate for the load. Typically used to inform team members of what rate they should target when covering freight. This value is not used directly, but can be referenced when setting up posting rules.

Show child attributes

Metadata Sync a load

⌘I

Concepts

Loads

Rates

Carrier Relationships