FreightProof API Reference

Integration Guide for TMS, Dispatch Systems, and AI Agents

FreightProof is API-first. Every capability available on the website is available through REST endpoints and MCP tools. One API call at dispatch time creates a signed vetting record.

Quick Start

Vet a carrier (one call)

``bash curl -X POST https://freight.rootz.global/api/vet \ -H "Content-Type: application/json" \ -d '{"dot_number": "123456", "broker_id": "YOUR_COMPANY"}' `

Response: `json { "vetting_id": "VET-a1b2c3d4-...", "dot_number": 123456, "carrier": "EXAMPLE TRUCKING LLC", "risk_score": 18, "risk_level": "LOW", "recommendation": "APPROVE", "red_flags": [], "data_hash": "a3f8b2c1d4e5...(SHA-256)", "vetting_date": "2026-06-17T14:30:00.000Z", "basics": { "unsafe_driving": 42, "crash_indicator": 28, ... }, "snapshot_available": true } `

That's it. One POST, one signed record, courtroom-ready.

REST API Endpoints

Carrier Intelligence

Vetting (The Montgomery Defense)

Proof of Good Care

System

MCP Tools (for AI Agents)

FreightProof exposes 12 MCP tools via HTTP transport at POST /mcp (JSON-RPC 2.0).

Any AI agent that supports MCP can call these tools directly:

MCP Configuration

Add to your AI agent's MCP configuration:

`json { "mcpServers": { "freight": { "url": "https://freight.rootz.global/mcp", "transport": "http" } } } `

Integration Patterns

Pattern 1: Dispatch-Time Vetting (Recommended)

Call /api/vet at the moment of dispatch. Store the vetting_id and data_hash with the load record.

`javascript // At dispatch time const response = await fetch('https://freight.rootz.global/api/vet', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ dot_number: carrier.dotNumber, broker_id: 'YOUR_COMPANY' }) });

const vetting = await response.json();

if (vetting.recommendation === 'REJECT') { // Do not dispatch — document the rejection return { dispatched: false, reason: vetting.red_flags }; }

// Store proof with the load load.vetting_id = vetting.vetting_id; load.vetting_hash = vetting.data_hash; load.vetting_score = vetting.risk_score; `

Pattern 2: Batch Daily Vetting

Vet your entire active carrier list daily. Flag changes.

`javascript const response = await fetch('https://freight.rootz.global/api/batch-vet', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ dot_numbers: [123456, 234567, 345678, ...], broker_id: 'YOUR_COMPANY' }) }); `

Pattern 3: Proof of Good Care (Full Lifecycle)

Create a care document at dispatch, append events through the shipment lifecycle.

`javascript // 1. Create document at dispatch const care = await fetch('https://freight.rootz.global/api/care', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ shipment: { ref: 'SHIP-001', commodity: 'Electronics', value_usd: 50000 }, parties: { broker: 'YOUR_CO', carrier: 'CARRIER_CO' }, vetting_id: 'VET-xxx' // Links to the dispatch vetting record }) });

// 2. Append pickup event await fetch(https://freight.rootz.global/api/care/${care.document_id}/event, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ stage: 'PICKUP_HANDOFF', actor: 'Driver: John Smith', evidence: { condition: 'good', seal_number: 'SEAL-12345', pieces: 24 } }) });

// 3. Verify the document at any time const verify = await fetch( https://freight.rootz.global/api/care/${care.document_id}/verify ); // Returns: { valid: true, events_verified: 3, problems: [] } `

Pattern 4: AI Agent Integration

Your AI dispatch agent uses MCP tools to vet carriers automatically:

` Agent: "Vet carrier DOT 123456 for a load from Chicago to Miami" → Calls freight_carrier_vet(dot_number: 123456, broker_id: "AGENT_DISPATCH") → Returns: risk_score: 32, recommendation: "CAUTION", red_flags: ["BASIC Unsafe Driving at 72nd percentile"] Agent: "Risk is medium. Flagging for human review before dispatch." `

Verification (No Auth Required)

Any vetting record can be independently verified:

`bash

Get the vetting record

`bash curl https://freight.rootz.global/api/care/POGC-xxx/verify

Returns: { valid: true, events_verified: N, problems: [] }

Data Behind the API

Rate Limits & Pricing

No subscriptions. No monthly fees. Credit-based access.

Credits never expire. Each vetting record consumes one credit.

freight.rootz.global · Rootz Corp · steven@sprague.com