Look up current freight rates for a lane | Freight Rate Intelligence API

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

{
  "ok": true,
  "data": {
    "rate_per_mile": 2.4521,
    "total_cost": 2354.02,
    "miles": 960,
    "currency": "USD",
    "origin": "Dallas, TX",
    "destination": "Chicago, IL",
    "equipment": "DRY_VAN",
    "equipment_display": "Dry Van (53')",
    "mode": "FTL",
    "rate_type": "ALL",
    "include_fuel_surcharge": true,
    "as_of": "2023-01-15",
    "confidence": {
      "level": "HIGH",
      "score": 0.9,
      "label": "Modeled estimate — high confidence (cost-basis, regional inputs)",
      "factors": [
        "PADD regional diesel price",
        "Precomputed mileage table"
      ]
    },
    "ams_validation": {
      "anchored": true,
      "ams_rate_low": 1.1,
      "ams_rate_high": 1.1,
      "ams_national_avg": 1.1,
      "ams_region": "string",
      "ams_distance_band": "string",
      "ams_observation_date": "2023-01-15",
      "ams_series": "FVWTRK",
      "deviation_pct": 1.1
    },
    "narrative": {
      "summary": "string",
      "fuel_explanation": "string",
      "labor_explanation": "string",
      "demand_explanation": "string",
      "ams_explanation": "string",
      "confidence_explanation": "string",
      "full_narrative": "string"
    },
    "cost_components": {
      "fuel_per_mile": 0.6123,
      "reefer_unit_per_mile": 1.1,
      "labor_per_mile": 0.7692,
      "equipment_per_mile": 0.35,
      "margin_per_mile": 0.15,
      "fuel_surcharge_per_mile": 0.3917
    },
    "data_sources": {
      "diesel_price": 1.1,
      "diesel_source": "string",
      "diesel_series": "string",
      "diesel_unit": "USD/gallon",
      "labor_rate": 1.1,
      "labor_source": "string",
      "labor_series": "string",
      "labor_updated": "string",
      "labor_unit": "USD/hour",
      "distance_miles": 1.1,
      "distance_source": "string",
      "equipment_mpg": 1.1,
      "equipment_mpg_source": "string",
      "reefer_gal_per_hour": 1.1,
      "reefer_source": "string",
      "fsc_formula": "string"
    },
    "capacity_pressure": {
      "index": 55,
      "label": "BALANCED",
      "region": "South Central",
      "adjustment": "2.5%"
    },
    "market_state": "TIGHT",
    "demand_multiplier": 1.1,
    "tsi_value": 1.1,
    "tsi_change_pct": 1.1,
    "market_state_interpretation": "string",
    "model_type": "COST_BASIS",
    "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"
      }
    ],
    "as_of_warning": "string",
    "low_confidence_warning": "string",
    "rate_type_note": "string"
  },
  "receipt_id": "rcpt_01abc...",
  "auth_obj_id": "auth_01xyz..."
}

Returns a cost-basis freight rate estimate with per-mile cost breakdown, data source provenance, capacity pressure adjustment, and confidence grade. Every response includes a constitutional receipt ID.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

originstringRequired

Origin city and state

destinationstringRequired

Destination city and state

modeenumOptionalDefaults to FTL

Freight mode

Allowed values:

equipmentenumOptional

Equipment type

Allowed values:

rate_typeenumOptionalDefaults to ALL

Reserved for future use. Currently all requests return cost-basis estimates regardless of rate_type value.

Allowed values:

include_fuel_surchargebooleanOptionalDefaults to true

Include fuel surcharge in rate

as_ofdate or nullOptional

Date for rate calculation. Defaults to today if omitted. Historical dates use most recent available data with a warning.

Response

Rate lookup result 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