Thank you for your interest in posting loads with TruckSmarter! This page will go over TruckSmarter's requirements for posting or updating loads on our platform.

Example JSON Body

{
   "loads": [
   {
     "load_id": "QP1397023E",
     "equipment": ["Gooseneck"],
     "contact_phone": "(999) 999-9999",
     "length": 53,
     "weight": 10000,
     "requirements": ["Tarps"],
     "commodity": "Lumber",
     "distance": 1545.00,
     "general_notes": "Straps and chains required",
     "contact_extension": "855",
     "contact_email":"bob&[email protected]",
     "offer_price": 1250.00,
     "stops": [
        {
          "start_time": "2022-11-22T08:15-07:00",
          "end_time": "2022-11-22T11:00-07:00",
          "address": "1234 Oak St.",
          "city": "San Diego",
          "state": "CA",
          "zip_code": "91942",
          "index": 0,
          "type": "P",
          "business": "Pacific Lumber Co.",
          "latitude": 32.71222926479714,
          "longitude": -117.17217806554811,
          "country": "US",
          "notes": null,
        },
        {
          "start_time": "2022-11-25T16:00-04:00",
          "end_time": "2022-11-25T18:00-04:00",
          "address": "567 Elm Ave.",
          "city": "Tampa",
          "state": "FL",
          "zip_code": "33592",
          "index": 1,
          "type": "D",
          "business": "Bob & Sons Shipyard",
          "latitude": 27.95172941786464,
          "longitude": -82.47456432449658,
          "country": "US",
          "notes": null,
        },
        {
          "start_time": "2022-11-22T08:15-04:00",
          "end_time": "2022-11-27T12:30-04:00",
          "address": "908 Birch Dr.",
          "city": "Toronto",
          "state": "ON",
          "zip_code": "M5W 1E6",
          "index": 2,
          "type": "D",
          "business": "Cal Construction",
          "latitude": 43.68295395359655,
          "longitude": -79.431873084697,
          "country": "CAN",
          "notes": "Enter location from Birch Dr. entrance",
        },
     	],
   },
   {
     "load_id": "QP1397557A",
     "equipment": ["Van"],
     "contact_phone": "(999) 999-9999",
     "length": 53,
     "weight": 20000,
     "requirements": null,
     "commodity": null,
     "distance": 1545.00,
     "general_notes": null,
     "contact_extension": null,
     "contact_email": null,
     "offer_price": 200.00,
     "stops": [
        {
          "start_time": "2022-11-22T08:15-07:00",
          "end_time": null,
          "address": null,
          "city": "Aberdeen",
          "state": "WA",
          "zip_code": "98520",
          "index": 0,
          "type": "P",
          "business": null,
          "latitude": 46.97588939792236,
          "longitude": -123.8186960711611,
          "country": "US",
          "notes": null,
        },
        {
          "start_time": "2022-11-25T16:00-07:00",
          "end_time": null,
          "address": null,
          "city": "Portland",
          "state": "OR",
          "zip_code": "97035",
          "index": 1,
          "type": "D",
          "business": null,
          "latitude": 45.55842489384122,
          "longitude": -122.68411869469288,
          "country": "US",
          "notes": null,
        },
     	],
   },
   ]
}

load Fields

NameTypeRequired*Description
load_idstringYesThe code by which your company internally identifies the load.
equipmentarray of stringsYesThe equipment type you require of the carrier. These are discussed in the Equipment section below.
contact_phonestringYesThe number you would like carriers to call in order to negotiate and book the load.
lengthintegerNoThe length of the trailer you require of the carrier in feet.
weightintegerNoThe weight of the load expected to be hauled in pounds.
requirementsarray of stringsNoRequirements the carrier is expected to undertake. These are discussed in the Requirements section.
commoditystringNoThe commodity you require the carrier to haul.
distancefloatNoThe distance of the entire trip as travelled by road in miles.
general_notesstringNoNotes you would like to provide to the carrier that apply to the load and general trip.
contact_extensionstringNoAny phone extension required in addition to the provided ContactPhone.
contact_emailstringNoThe email address you would like carriers to contact in order to negotiate and book the load.
offer_pricefloatYesThe initial price you suggest for potential carriers in US dollars.
stopsarray of stop objectsYesThe stops which the carrier is intended to make, as defined in a stop object in a schema outlined below. Note that a load requires at least two.

*Fields not required can be omitted from the payload or set to null.

stop Fields

NameTypeRequired*Description
start_timestring (ISO datetime with timezone)YesThe date and time the carrier is expected to arrive. This can also be the initial time the carrier can arrive, if providing an appointment range. The ISO datetime with timezone is mandatory.
end_timestring (ISO datetime with timezone)NoThe end time of an appointment range during which a carrier can arrive. The ISO datetime with timezone is mandatory.
addressstringNoThe specific address at which a stop is made.
citystringYesThe city at which a stop is made.
statestringYesThe two-letter-code of the state at which a stop is made.
zip_codestringYesThe zip code at which a stop is made.
indexintegerYesThe order in which the stops are to be made. Note that the count starts with 0.
typestringYesIndicates to the carrier whether this stop is a pickup (P) or delivery (D) stop.
businessstringNoThe name of the business at which the carrier will stop.
latitudelongYesThe coordinate latitude of the stop location.
longitudelongYesThe coordinate longitude of the stop location.
countrystringYesThe location country of the stop. Currently, only US (United States) and CAN (Canada) are supported.
notesstringNoNotes you would like to provide to the carrier regarding a specific stop.

*Fields not required can be omitted from the payload or set to null.

Equipment Codes

You can find the list of equipment below. Please provide any equipment types that can be used to haul your load in an array. Should your equipment type be missing from the list, please leave this in the GeneralNotes field instead.

Equipment
Van
Reefer
Flatbed
Container
Stepdeck
PowerOnly
Gooseneck
HotShot
BoxTruck
Conestoga
AnimalCarrier
CarCarrier
CargoVan
DumpTruck
BoatHauler
HopperBottom
Tanker
Partial
Other

Requirement Codes

You can find the list of requirements and what they refer to below. Please provide any requirements needed to haul your load in an array. If you have no requirements, please make the field null. Should your requirement be missing from the list, please leave this in the GeneralNotes field instead.

Requirements
AirRide
BTrain
CTPAT
DropTrailer
Team
WalkingFloor
FoodGrade
Straps
Chains
TankerEndorsement
Maxi
Curtains
Overdimensional
PPE
Ramp
SideKit
Tarps
DoubleDrop
Vented
TWIC
LowBoy
Hazmat

Note on Updating Loads

Updating is just as easy as posting the load with the updated contents. So long as the prior load has a matching load id, your load will be updated.
Similarly if you have a load in one posting that is removed from a future posting, our platform will consider that load unavailable and remove it.

Language
Authorization
Header
Click Try It! to start a request and see the response here!