# Haulroll API by CyberMax

> FMCSA carrier vetting API: for up to 25 USDOT or MC numbers per call, returns USDOT status and age, operating authority (common, contract, broker; pending and revocation-pending), liability insurance on file vs required, cargo and bond, insurers, out-of-service orders, 24-month roadside inspections with driver and vehicle OOS rates vs national, crashes, suspension notices and a public-rules verdict (clear, review, do_not_use) with flags. Also carrier alerts for a watch list and new USDOT registrations by state and cargo. REST + MCP server.

Send up to 25 USDOT or MC numbers and get a verdict for each (clear, review, do not use) with the FMCSA facts behind it: USDOT status, operating authority, insurance on file vs required, out-of-service orders, 24-month inspections and crashes vs the national rate. For freight brokers, shippers, 3PLs, factoring and insurance teams, TMS builders and AI agents. Free tier, no key; plans from $19/month.

## API (free tier without a key; paid API keys for more)
- [/api/carrier](https://haulroll-api.cybermax-tools.workers.dev/api/carrier?dot=80806,MC681958): Vet up to 25 carriers by USDOT or MC number: verdict with FMCSA evidence
- [/api/alerts](https://haulroll-api.cybermax-tools.workers.dev/api/alerts?dot=80806,1341816&days=30): Monitor a carrier list: FMCSA events in the last N days
- [/api/new-carriers](https://haulroll-api.cybermax-tools.workers.dev/api/new-carriers?state=TX&days=7&limit=20): New USDOT registrations: carriers FMCSA added in the last N days
- GET for simple calls, POST a JSON body for lists. Same field names as the bulk version's dataset records.
- OpenAPI 3.1: https://haulroll-api.cybermax-tools.workers.dev/openapi.json

## MCP (remote, streamable HTTP, no auth)
- Endpoint: https://haulroll-api.cybermax-tools.workers.dev/mcp
- `vet_carriers`: Verdict for 1-25 US motor carriers by USDOT or MC/MX/FF number: USDOT status and age, operating authority, liability insurance on file vs required, out-of-service orders, 24-month inspections (driver/vehicle OOS rates vs national) and crashes, with flags. Riskiest first.
- `carrier_alerts`: FMCSA events in the last N days for up to 25 carriers: out-of-service orders, authority suspension notices and status changes, insurance cancellations. Empty = nothing new.
- `new_carriers`: Carriers FMCSA added in the last N days (active only), filterable by state, cargo, hazmat, interstate and for-hire. Company facts only.

## Limits
- Up to 25 carriers per call; 10 calls a minute per IP on the free tier.
- Free tier: 50 calls a day per IP, no key. Paid keys from $19/month (see Get an API key).
- Data: FMCSA's public files on data.transportation.gov (Company Census, Licensing & Insurance, Out-of-Service Orders, inspections, crashes). FMCSA updates them daily; answers are cached up to 6 hours.
- The verdict is a transparent rule set on public FMCSA data, not an FMCSA safety rating or a guarantee; your own carrier policy still decides. Company facts only: no phone numbers, emails or officer names.

## More
- Health: https://haulroll-api.cybermax-tools.workers.dev/health
- All CyberMax tools: https://cybermax-tools-cybermax.static.hf.space/
- Loop over longer lists 25 carriers at a time: a Broker key covers 750 calls, up to 18,750 carrier checks a month. Run /api/alerts on your carrier list every morning to catch out-of-service orders, suspensions and insurance cancellations.

## Pricing
- Free: 50 calls a day per IP, 10/min, no key.
- Broker: $19/month, 750 calls a month, 30/min. Buy: https://haulroll-api.cybermax-tools.workers.dev/buy/broker?s=llms
- Brokerage: $49/month, 3,500 calls a month, 60/min. Buy: https://haulroll-api.cybermax-tools.workers.dev/buy/brokerage?s=llms
- Platform: $99/month, 15,000 calls a month, 120/min. Buy: https://haulroll-api.cybermax-tools.workers.dev/buy/platform?s=llms
- Pay as you go: $5, 200 calls (one-time pack, no expiry), 30/min. Buy: https://haulroll-api.cybermax-tools.workers.dev/buy/payg?s=llms
- Broker yearly: $190/year, 750 calls a month, 30/min. Buy: https://haulroll-api.cybermax-tools.workers.dev/buy/broker-yearly?s=llms
- Brokerage yearly: $490/year, 3,500 calls a month, 60/min. Buy: https://haulroll-api.cybermax-tools.workers.dev/buy/brokerage-yearly?s=llms
- Platform yearly: $990/year, 15,000 calls a month, 120/min. Buy: https://haulroll-api.cybermax-tools.workers.dev/buy/platform-yearly?s=llms
- Using several CyberMax APIs? CyberMax API All-Access: one key for all 9 APIs (this one included, 750 calls a month here) for $119/month. https://api-all-access.cybermax-tools.workers.dev/
- Use the key as `x-api-key: KEY` or `Authorization: Bearer KEY` (MCP too). Usage: https://haulroll-api.cybermax-tools.workers.dev/key. Machine-readable: https://haulroll-api.cybermax-tools.workers.dev/pricing.json