TrukTek Developer Docs

Step 1 — Get a token

POST https://www.truktek.com/api/auth/device
Content-Type: application/json

{
  "passphrase": "amber-cargo-freight-river"
}

Response 200 OK

{
  "token": "eyJhbGciOiJIUzI1NiJ9...",
  "expiresAt": "2027-07-09T00:00:00.000Z",
  "user": {
    "id": "abc123",
    "email": "dispatch@yourcompany.com",
    "companyId": "1234567",
    "dotnumber": "1234567"
  }
}

Store the token securely. You can regenerate your passphrase from Profile at any time — doing so immediately invalidates any tokens issued from the previous one.

Step 2 — Use the token

Include the token in every request as a Bearer token in the Authorization header.

Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...

Query parameters

Example request

GET https://www.truktek.com/api/loads?octy=Atlanta&ost=GA&dcty=Dallas&dst=TX&freight=Reefer

Response 200 OK

{
  "loads": [
    {
      "loadId": "abc123",
      "octy": "Atlanta",    "ost": "GA",
      "dcty": "Dallas",     "dst": "TX",
      "equip": "Reefer",
      "ratePay": 2400,
      "pickupDate": "2026-07-10T00:00:00.000Z",
      "deliveryDate": "2026-07-12T00:00:00.000Z",
      "shipperNm": "Broker Name",
      "weight": 44000,
      "length": 53,
      "loadDist": 783.4,
      "grossRpm": 2.31,
      "o2oDist": 12.1,
      "coordinates": [[lon, lat], ...]
    },
    ...
  ],
  "total": 847,
  "geo": { "olat": 33.748, "olon": -84.387, "dlat": 32.779, "dlon": -96.808 }
}

Request body (JSON)

Example request

POST https://www.truktek.com/api/loads/search
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Content-Type: application/json

{
  "octy": "Atlanta",
  "ost": "GA",
  "dcty": "Dallas",
  "dst": "TX",
  "freight": "Reefer",
  "milesSlider": 300,
  "gross_rpm": 2.0
}

Query parameters

Example request

GET https://www.truktek.com/api/loads/rate-check?octy=Atlanta&ost=GA&dcty=Dallas&dst=TX&freight=Reefer
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...

Response 200 OK

{
  "lane": "Atlanta, GA → Dallas, TX",
  "equipment": "Reefer",
  "sample_count": 34,
  "avg_rpm": 2.31,
  "min_rpm": 1.87,
  "max_rpm": 3.12,
  "median_rpm": 2.24,
  "avg_pay": 1810
}

If no loads are found, sample_count is 0 and a message field explains why rather than returning rate fields.

Request body (JSON)

Example request

POST https://www.truktek.com/api/loads/chain
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Content-Type: application/json

{
  "octy": "Seattle",
  "ost": "WA",
  "dcty": "Boston",
  "dst": "MA",
  "startDate": "2026-07-14",
  "endDate": "2026-07-21",
  "freight": "Van",
  "maxDeadhead": 150
}

Response 200 OK

{
  "chains": [
    {
      "loads": [
        {
          "id": "abc123",
          "octy": "Seattle",   "ost": "WA",
          "dcty": "Chicago",   "dst": "IL",
          "origLat": 47.606,   "origLon": -122.332,
          "destLat": 41.878,   "destLon": -87.629,
          "rateAmount": 3200,
          "totalMiles": 2064,
          "pickupDateMs": 1752451200000,
          "deliveryDateMs": 1752624000000,
          "equip": "Van",
          "routeCoords": [[lon, lat], ...]
        },
        {
          "id": "def456",
          "octy": "Chicago",   "ost": "IL",
          "dcty": "Boston",    "dst": "MA",
          ...
        }
      ],
      "totalMiles": 4198,
      "totalGross": 5900,
      "overallRpm": 1.41
    },
    ...
  ],
  "candidateCount": 8423,
  "searchTimeMs": 4821,
  "originLat": 47.606,
  "originLon": -122.332
}

Up to 5 chains are returned, sorted by overallRpm descending. Each chain's loads array is ordered sequentially — leg 1 → leg 2 → … → final leg.candidateCount shows how many loads were evaluated in the search.

Query parameters

Example request

GET https://www.truktek.com/api/mileage?from=30301&to=90210
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...

curl

curl "https://www.truktek.com/api/mileage?from=30301&to=90210" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9..."

Response 200 OK

{
  "from": { "zip": "30301", "city": "Atlanta", "state": "GA" },
  "to":   { "zip": "90210", "city": "Beverly Hills", "state": "CA" },
  "miles": 2183,
  "matchedLane": {
    "from": "Atlanta, GA",
    "to": "Los Angeles, CA"
  }
}

matchedLane shows the TomTom reference lane that was used to produce the mileage figure. It may differ slightly from the exact zip pair when no lane originates at the precise zip location.

Request body

Example request

POST https://www.truktek.com/api/bandit
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Content-Type: application/json

{
  "message": "Find reefer loads from Atlanta GA to Dallas TX pickup tomorrow",
  "history": []
}

Response — SSE stream

The response is Content-Type: text/event-stream. Each event is a line beginning with data: followed by a JSON object, terminated by .

data: {"type":"tool_start","tool":"search_loads","label":"Searching Atlanta GA → Dallas TX · Reefer…"}

data: {"type":"tool_result","tool":"search_loads","label":"Found 8 loads (8 total)","ok":true}

data: {"type":"text","content":"Found 8 reefer loads from Atlanta to Dallas picking up tomorrow."}

data: {"type":"text","content":" Best rate is $2.31/mi ($1,940 total). Want me to shortlist the top 3?"}

data: {"type":"done","history":[...]}

SSE event types

Reading the stream — JavaScript example

const res = await fetch("https://www.truktek.com/api/bandit", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer eyJhbGciOiJIUzI1NiJ9...",
  },
  body: JSON.stringify({ message: "Find reefer loads Atlanta to Dallas", history: [] }),
});

const reader = res.body.getReader();
const decoder = new TextDecoder();
let buffer = "";
let history = [];

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });

  const parts = buffer.split("\n\n");
  buffer = parts.pop() ?? "";

  for (const part of parts) {
    if (!part.startsWith("data: ")) continue;
    const event = JSON.parse(part.slice(6));

    if (event.type === "text") process.stdout.write(event.content);
    if (event.type === "done") history = event.history; // save for next turn
  }
}

Request

Send the file as multipart/form-data with field name file. Supported formats: JPG, PNG, PDF. Max size: 4 MB (compress images before sending if needed).

POST https://www.truktek.com/api/tools/bol
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Content-Type: multipart/form-data

file: <BOL image or PDF>

curl

curl -X POST "https://www.truktek.com/api/tools/bol" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9..." \
  -F "file=@/path/to/bol.jpg"

Response 200 OK

{
  "result": "<h3>Shipper</h3><p><strong>Name:</strong> ABC Freight Co</p>...",
  "remaining": null
}

remaining is null for authenticated users (no cap). For anonymous users it shows how many free scans remain. Processing typically takes 10–20 seconds — set your timeout to at least 60 seconds.

Request

POST https://www.truktek.com/api/tools/invoice
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Content-Type: multipart/form-data

file: <invoice image or PDF>

curl

curl -X POST "https://www.truktek.com/api/tools/invoice" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9..." \
  -F "file=@/path/to/invoice.pdf"

Response 200 OK

{
  "result": "<h3>Invoice</h3><p><strong>Invoice #:</strong> INV-2024-1089</p>...",
  "remaining": null
}