API docs

Every morning Haulflare flags the U.S. trucking companies that have to buy or switch commercial auto insurance, from public FMCSA filings. The API gives you that list as JSON, as CSV, or straight into a Google Sheet.

Quick start

Google Sheets

Paste this into cell A1 of a new sheet. It refreshes about once an hour.

=IMPORTDATA("https://haulflare.com/v1/triggers?format=csv&state=TX&api_key=YOUR_API_KEY")

curl

curl -H "x-api-key: YOUR_API_KEY" \
  "https://haulflare.com/v1/triggers?state=TX&sort=deadline&limit=50"

JavaScript

const res = await fetch('https://haulflare.com/v1/triggers?state=TX&trigger=CANCELLATION_PENDING', {
  headers: { 'x-api-key': process.env.HAULFLARE_KEY },
});
const { total, data } = await res.json();

Python

import requests
r = requests.get("https://haulflare.com/v1/triggers",
                 params={"state": "TX", "min_trucks": 5, "sort": "deadline"},
                 headers={"x-api-key": HAULFLARE_KEY})
leads = r.json()["data"]

Authentication

Send your key in the x-api-key header. Spreadsheets can't send headers, so the key also works as an api_key query parameter; use that only where you have to.

A key only returns the states and data your plan covers. Keep it private: anyone with it can pull your list. If it leaks, replace it on the API & Sheets page; the old key stops working at once.

Limits & freshness

• New FMCSA data is processed every morning; the day's list is ready by about 6 AM Eastern.
• Up to 120 requests a minute. Responses over the limit get 429; wait a minute and retry.
• JSON pages hold up to 500 rows by default (limit up to 10,000). CSV returns up to 10,000 rows in one go.
• Dates are YYYY-MM-DD; timestamps are ISO 8601 in UTC.

The daily list

Active triggers in your states, newest first unless you choose a sort. A carrier can appear once per signal.

Response

{
  "total": 1284,
  "limit": 500,
  "offset": 0,
  "count": 500,
  "data": [
    {
      "id": 48211,
      "trigger": "CANCELLATION_PENDING",
      "trigger_label": "Policy cancellation pending",
      "dot_number": "3456789",
      "mc_number": "MC1234567",
      "legal_name": "LONE STAR HAULING LLC",
      "dba_name": null,
      "city": "DALLAS",
      "state": "TX",
      "zip": "75201",
      "phone": "(214) 555-0193",
      "cell_phone": null,
      "email": "[email protected]",
      "officer_name": "DAVID MILLER",
      "power_units": 8,
      "total_drivers": 9,
      "is_hazmat": false,
      "current_insurer": "ACME MUTUAL",
      "policy_number": "CA-55120",
      "policy_effective_date": "2025-11-14",
      "target_action_date": "2026-11-14",
      "confidence": "high",
      "details": { "days_left": 19, "coverage_amount": 750, "form": "91X" },
      "detected_at": "2026-10-26T10:04:12.000Z"
    }
  ]
}

Insurer exit watchlist

Per-insurer cancellation rates for trucking liability policies, from the latest daily snapshot. Insurers cancelling far faster than the market are flagged; their policyholders show up in the list as INSURER_EXIT_RISK.

{
  "snapshot_date": "2026-10-26",
  "data": [
    {
      "insurer": "BADCO INSURANCE",
      "book_size": 1840,
      "cancels_30d": 212,
      "baseline_monthly_cancels": 61,
      "cancel_rate_30d": 0.115,
      "market_cancel_rate_30d": 0.031,
      "trend_ratio": 3.5,
      "flagged": true,
      "flag_reason": "cancelling 11.5% of its book in 30 days vs 3.1% market-wide"
    }
  ]
}

Fields

Signals

Confidence

Errors

Errors come back as JSON with a message that says what to fix.

{ "statusCode": 403, "message": "Your plan does not include state(s): CA", "error": "Forbidden" }

Questions or something missing? Email [email protected].