---

This is old documentation for Version 0 of our API. For our current V1 api, please refer to https://apidocs.directfreight.com/

---

Direct Freight allows approved posting companies to post directly to our website via XML endpoints at:

http://www.directfreight.com/home/api/liveloads
http://www.directfreight.com/home/api/livetrucks
http://www.directfreight.com/home/api/testloads (view test loads here)
http://www.directfreight.com/home/api/testtrucks (view test trucks here)
http://www.directfreight.com/home/api/loads (deprecated) -- live loads always returns SUCCESS
http://www.directfreight.com/home/api/trucks (deprecated) -- live trucks always returns SUCCESS


This endpoint accepts loads in XML format.
A sample XML post would look like this: samplepost.xml
Here is a sample form that formats/posts a load to our site: XMLLoadPost.html
Sample Error Messages: sample_errors.txt

Below is a detailed breakout of all the fields sent in an XML request with descriptions where necessary:

• LoadPostings/TruckPostings
  • PostingAccount
    • Username
      • Direct Freight Username -- Either Username or CompanyName is required
    • Password
      • Required if username is present otherwise unused
    • ContactName
      • Dispatcher's name -- Optional
    • ContactPhone
      • Dispatcher's phone number -- Required if Username is blank otherwise optional
    • ContactFax (optional)
    • ContactEmail (optional)
    • CompanyName
      • Required if Username is blank otherwise unused
    • UserID
      • Username or unique identifier used on your site to identify your customer
    • DeleteCurrentBeforePosting (optional -- default is false)
    • TMS_username ignored by Direct Freight
    • TMS_password ignored by Direct Freight
  • PostLoads/PostTrucks/RemoveLoads/RemoveTrucks
    • load/truck
      • tracking-number (required-This field needs to be unique for each load. To remove a posting use the remove function with the same unique ID you used to post the original load, to update a load repost the load using the ID of the original load)
      • origin
        • city (required)
        • state (required)
        • postcode/zipcode (optional)
        • county (optional)
        • country (optional)
        • latitude (optional)
        • longitude (optional)
        • date-start
          • year (required)
          • month (required)
          • day (required)
          • hour (optional)
          • minute (optional)
        • date-end
          • year
          • month
          • day
          • hour (optional)
          • minute (optional)
      • destination
        • city (required)
        • state (required)
        • postcode/zipcode (optional)
        • county (optional)
        • country (optional)
        • latitude (optional)
        • longitude (optional)
        • date-start
          • year
          • month
          • day
          • hour (optional)
          • minute (optional)
        • date-end
          • year
          • month
          • day
          • hour (optional)
          • minute (optional)
      • equipment (required)
        Sample format: "equipment" => { f => { tarps => "true" } },
        Sample format: "equipment" => "F+T",
        Sample format: "equipment" => { V => {} },
      • loadsize/trucksize fullload=true (required)
        • length (optional)
        • width (optional)
        • height (optional)
        • weight (optional)
      • load-count/truck-count (optional)
      • stops (optional)
      • distance (optional)
      • rate (optional)
      • comment (optional)
      • dispatch-phone (optional)

---

---