FreightPulse API documentation

{
  "success": true,
  "data": { ... }
}

{
  "success": false,
  "error": "Invalid API key"
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://freightpulsehq.com/api/v1/fuel-prices"

{
  "success": true,
  "data": {
    "timestamp": "2026-07-30T12:00:00Z",
    "source": "EIA (U.S. Energy Information Administration)",
    "currency": "USD",
    "unit": "gallon",
    "data": {
      "diesel": {
        "national_average": 3.847,
        "change_week": -0.023,
        "change_percent": -0.6,
        "updated_at": "2026-07-27",
        "regions": {
          "east_coast": 3.912,
          "midwest": 3.756,
          "gulf_coast": 3.623,
          "rocky_mountain": 3.891,
          "west_coast": 4.456,
          "california": 4.892
        },
        "historical": { "30d_avg": 3.82, "90d_avg": 3.75, "yoy_change_percent": -8.2 }
      },
      "gasoline": {
        "national_average": 3.156,
        "regular": 3.156,
        "historical": { "30d_avg": 3.1, "90d_avg": 3.05, "yoy_change_percent": 1.1 }
      },
      "bunker_fuel": {
        "available": false,
        "note": "No known free source — requires a paid provider"
      }
    }
  }
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://freightpulsehq.com/api/v1/carriers?q=54283"

{
  "success": true,
  "data": {
    "type": "trucking",
    "query": "54283",
    "results": [
      {
        "dot_number": 54283,
        "legal_name": "SWIFT TRANSPORTATION COMPANY OF ARIZONA LLC",
        "dba_name": null,
        "entity_type": "Interstate",
        "status": "active",
        "safety_rating": "S",
        "power_units": null,
        "drivers": 12883,
        "address": { "city": "Phoenix", "state": "AZ", "country": "US" }
      }
    ]
  }
}

{
  "success": true,
  "data": {
    "type": "ocean",
    "query": "maersk",
    "results": [
      {
        "org_no": "021234",
        "legal_name": "MAERSK LOGISTICS (USA) INC.",
        "trade_name": null,
        "tariff_location": "https://www.maersk.com"
      }
    ]
  }
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://freightpulsehq.com/api/v1/freight-rates?mode=trucking&origin_zip=10001&destination_zip=90210"

{
  "success": true,
  "data": {
    "mode": "trucking",
    "service": "FTL (53' dry van)",
    "source": "Warp",
    "price_usd": 7207.92,
    "transit_days": 4,
    "pickup_date": "2026-08-24",
    "delivery_date": "2026-08-28",
    "valid_until": "2026-08-23T20:34:49.419Z"
  }
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://freightpulsehq.com/api/v1/port-congestion?port=USLAX"

{
  "success": true,
  "data": {
    "results": [
      {
        "port": "Los Angeles-Long Beach",
        "locode": "US LAX",
        "country": "United States",
        "congestion": "moderate",
        "as_of": "2026-08-14",
        "metrics": {
          "recent_avg_portcalls_per_day": 8.7,
          "baseline_avg_portcalls_per_day": 10.2,
          "ratio_vs_baseline": 0.85
        }
      }
    ],
    "meta": {
      "source": "IMF PortWatch (portwatch.imf.org) - UN Global Platform AIS data",
      "data_lag_days": "~6-7 (daily updates, not real-time)",
      "methodology": "congestion level is an approximation: last 7 days' avg port calls vs 90-day baseline for the same port. Does not measure vessel wait/anchorage time."
    }
  }
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://freightpulsehq.com/api/v1/historical?metric=fuel_price_diesel_national&period=30d"

{
  "success": true,
  "data": {
    "metric": "fuel_price_diesel_national",
    "period": "30d",
    "from": null,
    "to": null,
    "series": [
      { "date": "2026-07-27", "value": 5.257 },
      { "date": "2026-08-03", "value": 5.343 },
      { "date": "2026-08-10", "value": 5.454 }
    ]
  }
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://freightpulsehq.com/api/v1/historical?metric=fuel_price_diesel_national&from=2010-01-01&to=2010-12-31"

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://freightpulsehq.com/api/v1/disruptions?port=USLAX&severity=high"

{
  "success": true,
  "data": {
    "results": [
      {
        "id": "gdacs:TC:1001305",
        "type": "cyclone",
        "severity": "moderate",
        "title": "Tropical Cyclone SAUDEL-26",
        "country": "Japan",
        "affected_countries": ["JPN"],
        "location": { "lat": 17.1, "lon": 147.3 },
        "starts_at": "2026-08-18T12:00:00+00:00",
        "source": "GDACS",
        "url": "https://www.gdacs.org/report.aspx?eventid=1001305"
      },
      {
        "id": "usgs:6000tm81",
        "type": "earthquake",
        "severity": "low",
        "magnitude": 6.7,
        "title": "M 6.7 - 31 km NW of Aniso, Peru",
        "location": { "lat": -14.64, "lon": -73.52 },
        "starts_at": "2026-08-20T18:00:18+00:00",
        "source": "USGS",
        "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000tm81"
      }
    ],
    "meta": {
      "sources": ["GDACS (EU JRC) - global natural hazards", "USGS Earthquake Hazards Program - global significant earthquakes", "NOAA/NWS - US-only severe weather alerts"],
      "coverage": "Natural hazards only. Does not cover geopolitical events, strikes, port closures, or canal disruptions.",
      "source_status": { "gdacs": "ok", "usgs": "ok", "nws": "ok" }
    }
  }
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://freightpulsehq.com/api/v1/export"

{
  "success": true,
  "data": [],
  "meta": {
    "endpoint": "export",
    "note": "awaiting a real data source"
  }
}