Description

This guide enables partners to integrate with our Load Posting API to create and delete freight loads in our system.

Base URI: https://api.trucksmarter.com

🔐 Authentication

All endpoints require an API key passed via the Authorization header:

Authorization: Bearer YOUR_API_KEY

🚚 Post and Update Loads

Create or update one or more loads

Request Path

/loads/postings/post/

Request Method

POST

Request Body

{
	"mcNumber": 999999,
  "loads": [
    {
      "load_id": "123456",
      "equipment": ["van", "reefer"],
      "contact_phone": "555-123-4567",
      "length": 53,
      "weight": 45000, // lbs
      "requirements": ["hazmat", "team"],
      "commodity": "Electronics",
      "distance": 750, // mi
      "general_notes": "Handle with care",
      "contact_extension": "202",
      "contact_email": "[email protected]",
      "offer_price": 2500, // dollars
      "stops": [
        {
          "start_time": "2025-06-01T08:00:00Z",
          "end_time": "2025-06-01T10:00:00Z",
          "address": "123 Main St",
          "city": "Chicago",
          "state": "IL",
          "zip_code": "60601",
          "index": 0,
          "type": "P", // P (Pickup) or D (Delivery)
          "business": "Warehouse A",
          "latitude": 41.8781,
          "longitude": -87.6298,
          "country": "US",
          "notes": "Use dock 5"
        },
        {
          "start_time": "2025-06-02T14:00:00Z",
          "city": "Detroit",
          "state": "MI",
          "index": 1,
          "type": "D",
          "latitude": 42.3314,
          "longitude": -83.0458,
          "country": "US"
        }
      ]
    }
  ]
}

🧾 JSON Schema Overview

Body

Field Type Required Description
mcNumber integer ✅ Unique identifier
loads Load[] ✅ Loads

Load

Field Type Required Description
load_id string ✅ Unique identifier
equipment Equipment[] ✅ Equipment types required
stops Stop[] ✅ Pickup/dropoff locations
contact_phone string ❌ (if contact_email is used) Primary contact phone
length integer ❌ Length of trailer in feet
weight float ❌ Weight in pounds
requirements Requirement[] ❌ Special requirements
commodity string ❌ Commodity type
distance float ❌ Route distance in miles
general_notes string ❌ General non-stop-specific notes
contact_email string ❌ (if contact_phone is used) Contact email
offer_price float ❌ Proposed offer price (USD)

Stop