Compare freight rates across multiple lanes | Freight Rate Intelligence API

curl -X POST https://freightrateintelligence.com/v1/lanes/compare \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "lanes": [
    {
      "origin": "Dallas, TX",
      "destination": "Chicago, IL"
    }
  ]
}'

{
  "ok": true,
  "data": {
    "lanes": [
      {
        "lane_index": 1,
        "lane_label": "string",
        "origin": "string",
        "destination": "string",
        "equipment": "string",
        "equipment_display": "string",
        "mode": "string",
        "distance_miles": 1.1,
        "rate_per_mile": 1.1,
        "total_rate": 1.1,
        "fuel_component": 1.1,
        "labor_component": 1.1,
        "transit_time_est_hours": 1.1,
        "volatility": "LOW",
        "trend": "RISING",
        "trend_pct_30d": 1.1,
        "capacity": "string",
        "capacity_pressure_index": 1.1,
        "observation_count_30d": 1,
        "confidence": {
          "level": "HIGH",
          "score": 1.1
        }
      }
    ],
    "ranking": [
      {
        "rank": 1,
        "lane_index": 1,
        "lane_label": "string",
        "score": 1.1,
        "rationale": "string"
      }
    ],
    "narrative": "string",
    "recommendation": {
      "best_lane_index": 1,
      "reasoning": "string",
      "caveats": [
        "string"
      ]
    },
    "confidence": {
      "level": "HIGH",
      "score": 1.1,
      "label": "string",
      "factors": [
        "string"
      ]
    },
    "model_type": "LANE_COMPARISON",
    "model_disclaimer": "string",
    "factor_versions": [
      {
        "source": "EIA",
        "series_id": "PET.EMD_EPD2DXL0_PTE_R30_DPG.W",
        "version": "latest",
        "fetched_at": "2024-01-15T09:30:00Z"
      }
    ],
    "duplicate_warning": "string"
  },
  "receipt_id": "rcpt_01abc...",
  "auth_obj_id": "auth_01xyz..."
}

Side-by-side comparison of 2+ lanes with ranking by cost, stability, or trend. Returns per-lane metrics, a ranked recommendation, and narrative summary. Requires Starter tier.

Authentication

AuthorizationBearer

Your Freight Rate Intelligence API key. Get one at freightrateintelligence.com/dashboard/settings

Request

This endpoint expects an object.

laneslist of objectsRequired

compare_bylist of enumsOptional

Dimensions to compare lanes on. Defaults to all.

rank_byenumOptionalDefaults to LOWEST_COST

Primary ranking criterion.

include_narrativebooleanOptionalDefaults to true

Response

Lane comparison with receipt

okboolean

dataobject

Skill-specific response data

receipt_idstring

auth_obj_idstring

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error