post https://api.trucksmarter.com/loads/postings/post/
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
| Name | Type | Required* | Description |
|---|---|---|---|
| load_id | string | Yes | The code by which your company internally identifies the load. |
| equipment | array of strings | Yes | The equipment type you require of the carrier. These are discussed in the Equipment section below. |
| contact_phone | string | Yes | The number you would like carriers to call in order to negotiate and book the load. |
| length | integer | No | The length of the trailer you require of the carrier in feet. |
| weight | integer | No | The weight of the load expected to be hauled in pounds. |
| requirements | array of strings | No | Requirements the carrier is expected to undertake. These are discussed in the Requirements section. |
| commodity | string | No | The commodity you require the carrier to haul. |
| distance | float | No | The distance of the entire trip as travelled by road in miles. |
| general_notes | string | No | Notes you would like to provide to the carrier that apply to the load and general trip. |
| contact_extension | string | No | Any phone extension required in addition to the provided ContactPhone. |
| contact_email | string | No | The email address you would like carriers to contact in order to negotiate and book the load. |
| offer_price | float | Yes | The initial price you suggest for potential carriers in US dollars. |
| stops | array of stop objects | Yes | The 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
| Name | Type | Required* | Description |
|---|---|---|---|
| start_time | string (ISO datetime with timezone) | Yes | The 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_time | string (ISO datetime with timezone) | No | The end time of an appointment range during which a carrier can arrive. The ISO datetime with timezone is mandatory. |
| address | string | No | The specific address at which a stop is made. |
| city | string | Yes | The city at which a stop is made. |
| state | string | Yes | The two-letter-code of the state at which a stop is made. |
| zip_code | string | Yes | The zip code at which a stop is made. |
| index | integer | Yes | The order in which the stops are to be made. Note that the count starts with 0. |
| type | string | Yes | Indicates to the carrier whether this stop is a pickup (P) or delivery (D) stop. |
| business | string | No | The name of the business at which the carrier will stop. |
| latitude | long | Yes | The coordinate latitude of the stop location. |
| longitude | long | Yes | The coordinate longitude of the stop location. |
| country | string | Yes | The location country of the stop. Currently, only US (United States) and CAN (Canada) are supported. |
| notes | string | No | Notes 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.