{ "openapi": "3.1.0", "info": { "title": "Haulroll API API", "version": "1.0.0", "summary": "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.", "description": "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.\n\nFree tier: 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. No key needed. Remote MCP server: https://haulroll-api.cybermax-tools.workers.dev/mcp\n\nPricing: free tier 50 calls/day per IP, no key. Paid API keys: Broker $19/month = 750 calls/month; Brokerage $49/month = 3,500 calls/month; Platform $99/month = 15,000 calls/month; Pay as you go $5 = 200 calls (one-time pack); Broker yearly $190/year = 750 calls/month; Brokerage yearly $490/year = 3,500 calls/month; Platform yearly $990/year = 15,000 calls/month. Get a key: https://haulroll-api.cybermax-tools.workers.dev/docs#pricing", "contact": { "name": "CyberMax", "url": "https://cybermax-tools-cybermax.static.hf.space/" }, "license": { "name": "Proprietary (free tier + paid API keys)", "identifier": "LicenseRef-CyberMax" }, "x-pricing": { "api": "Haulroll API", "currency": "USD", "free": { "price": 0, "callsPerDayPerIp": 50, "perMinutePerIp": 10, "key": "none needed" }, "plans": [ { "id": "broker", "name": "Broker", "price": 19, "billing": "per month", "calls": 750, "per": "calendar month (UTC)", "perMinute": 30, "buy": "https://haulroll-api.cybermax-tools.workers.dev/buy/broker?s=openapi" }, { "id": "brokerage", "name": "Brokerage", "price": 49, "billing": "per month", "calls": 3500, "per": "calendar month (UTC)", "perMinute": 60, "buy": "https://haulroll-api.cybermax-tools.workers.dev/buy/brokerage?s=openapi" }, { "id": "platform", "name": "Platform", "price": 99, "billing": "per month", "calls": 15000, "per": "calendar month (UTC)", "perMinute": 120, "buy": "https://haulroll-api.cybermax-tools.workers.dev/buy/platform?s=openapi" }, { "id": "payg", "name": "Pay as you go", "price": 5, "billing": "one-time", "calls": 200, "per": "until used", "perMinute": 30, "buy": "https://haulroll-api.cybermax-tools.workers.dev/buy/payg?s=openapi" }, { "id": "broker-yearly", "name": "Broker yearly", "price": 190, "billing": "per year", "calls": 750, "per": "calendar month (UTC)", "perMinute": 30, "buy": "https://haulroll-api.cybermax-tools.workers.dev/buy/broker-yearly?s=openapi" }, { "id": "brokerage-yearly", "name": "Brokerage yearly", "price": 490, "billing": "per year", "calls": 3500, "per": "calendar month (UTC)", "perMinute": 60, "buy": "https://haulroll-api.cybermax-tools.workers.dev/buy/brokerage-yearly?s=openapi" }, { "id": "platform-yearly", "name": "Platform yearly", "price": 990, "billing": "per year", "calls": 15000, "per": "calendar month (UTC)", "perMinute": 120, "buy": "https://haulroll-api.cybermax-tools.workers.dev/buy/platform-yearly?s=openapi" } ], "unit": "calls", "howToUse": { "header": "x-api-key: YOUR_KEY", "alt": [ "Authorization: Bearer YOUR_KEY", "?key=YOUR_KEY" ], "mcp": "send the key as Authorization: Bearer YOUR_KEY", "usage": "https://haulroll-api.cybermax-tools.workers.dev/key" }, "manageKey": "https://haulroll-api.cybermax-tools.workers.dev/manage", "allAccess": { "name": "CyberMax API All-Access", "apis": 9, "url": "https://api-all-access.cybermax-tools.workers.dev/?s=openapi-haulroll-api", "plans": [ { "id": "all-access", "price": 119, "billing": "per month", "callsHere": 750, "per": "calendar month (UTC)" }, { "id": "all-access-pack", "price": 32, "billing": "one-time", "callsHere": 200, "per": "until used" } ], "note": "One key for every CyberMax API; Haulroll counts it separately." }, "payments": "Stripe Checkout: card, Apple Pay, Google Pay, Link; sales tax/VAT handled by Stripe. Cancel any time at https://haulroll-api.cybermax-tools.workers.dev/manage." } }, "servers": [ { "url": "https://haulroll-api.cybermax-tools.workers.dev" } ], "paths": { "/api/carrier": { "get": { "tags": [ "Haulroll API" ], "summary": "Vet up to 25 carriers by USDOT or MC number: verdict with FMCSA evidence", "description": "For each carrier: verdict (clear / review / do_not_use), a 0-100 risk score and the flags that applied; USDOT status, registration date and age, MCS-150 date, operation, entity, fleet size, drivers, cargo; operating authority (common, contract, broker, pending, revocation pending); liability insurance on file vs required, cargo and bond, insurers on file; out-of-service orders; 24-month inspections with driver and vehicle OOS rates next to the national rate; 24-month crashes; suspension notices; SAFER and SMS links. Riskiest first.", "operationId": "vetCarriersGet", "parameters": [ { "name": "dot", "in": "query", "required": false, "description": "USDOT numbers and/or MC/MX/FF docket numbers, up to 25, separated by commas or spaces (or POST {\"carriers\": [...]})", "schema": { "type": "string" }, "example": "80806, MC681958" } ], "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "results": [ { "query": "USDOT 1185624", "status": "ok", "usdot": "1185624", "name": "LEE LOGISTIC", "verdict": { "level": "do_not_use", "riskScore": 100, "flags": [ { "level": "do_not_use", "code": "usdot_inactive", "text": "USDOT number status: Inactive" }, { "level": "do_not_use", "code": "no_active_authority", "text": "Interstate for-hire carrier without active operating authority" }, { "level": "do_not_use", "code": "insurance_below_required", "text": "Liability insurance on file $0 is below the required $750,000" }, { "level": "do_not_use", "code": "oos_order", "text": "Out-of-service order since 2026-09-01: New Entrant Revoked - Refusal of Audit/No Contact" }, { "level": "info", "code": "no_inspections", "text": "No roadside inspections in 24 months" } ] }, "carrier": { "usdot": "1185624", "legalName": null, "legalNameWithheld": true, "dbaName": "LEE LOGISTIC", "usdotStatus": "Inactive", "entity": [ "Carrier" ], "operation": "Interstate", "classification": [ "AUTHORIZED FOR HIRE" ], "city": "CHARLOTTE", "state": "NC", "zip": "28262", "country": "US", "registered": "2003-11-10", "ageDays": 8357, "mcs150Date": "2025-10-14", "mcs150AgeDays": 348, "mileage": 1, "mileageYear": 2024, "powerUnits": 1, "trucks": 1, "buses": 0, "drivers": 1, "cdlDrivers": 1, "hazmat": false, "cargo": [ "General freight", "Household goods" ], "docket": "MC479455" }, "authority": { "docket": "MC479455", "source": "FMCSA Licensing & Insurance", "common": "inactive", "contract": "none", "broker": "none", "type": "Property", "pendingApplication": false, "revocationPending": false, "bipdRequired": 750000, "bipdOnFile": 0, "cargoRequired": false, "cargoOnFile": false, "bondRequired": false, "bondOnFile": false }, "insurance": [], "oosOrders": [ { "date": "2026-09-01", "reason": "New Entrant Revoked - Refusal of Audit/No Contact", "rescinded": null, "active": true } ], "inspections24m": { "inspections": 0, "driverInspections": 0, "driverOos": 0, "vehicleInspections": 0, "vehicleOos": 0, "driverOosRate": null, "vehicleOosRate": null }, "crashes24m": { "crashes": 0, "fatalCrashes": 0, "injuryCrashes": 0, "towawayCrashes": 0, "fatalities": 0, "injuries": 0 }, "suspensionNotices": [], "links": { "safer": "https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=1185624", "sms": "https://ai.fmcsa.dot.gov/SMS/Carrier/1185624/CarrierRegistration.aspx" } }, { "query": "USDOT 80806", "status": "ok", "usdot": "80806", "name": "J B HUNT TRANSPORT INC", "verdict": { "level": "clear", "riskScore": 0, "flags": [] }, "carrier": { "usdot": "80806", "legalName": "J B HUNT TRANSPORT INC", "legalNameWithheld": false, "dbaName": "J B HUNT", "usdotStatus": "Active", "entity": [ "Freight forwarder", "Carrier", "Shipper", "Broker" ], "operation": "Interstate", "classification": [ "AUTHORIZED FOR HIRE" ], "city": "LOWELL", "state": "AR", "zip": "72745", "country": "US", "registered": "1974-06-01", "ageDays": 19111, "mcs150Date": "2025-07-07", "mcs150AgeDays": 447, "mileage": 1629835251, "mileageYear": 2024, "powerUnits": 25280, "trucks": 25280, "buses": 0, "drivers": 24116, "cdlDrivers": 23669, "hazmat": true, "cargo": [ "General freight", "Metal: sheets, coils, rolls", "Motor vehicles", "Logs, poles, beams, lumber", "Building materials", "Fresh produce", "Liquids/gases", "Intermodal containers", "Oilfield equipment", "Livestock", "Grain, feed, hay", "Meat", "US mail", "Chemicals", "Commodities dry bulk", "Refrigerated food", "Beverages", "Paper products", "Agricultural/farm supplies", "Construction", "Other: IEP" ], "docket": "MC135797" }, "authority": { "docket": "MC135797", "source": "FMCSA Licensing & Insurance", "common": "active", "contract": "active", "broker": "active", "type": "Property, Household goods, Broker", "pendingApplication": false, "revocationPending": false, "bipdRequired": 1000000, "bipdOnFile": 3500000, "cargoRequired": true, "cargoOnFile": true, "bondRequired": true, "bondOnFile": true }, "insurance": [ { "insurer": "TRAVELERS CASUALTY & SURETY CO. OF AMERICA", "type": "Bond", "form": "84", "coverage": 0, "effective": "2014-01-13" }, { "insurer": "SELF-INSURED", "type": "BIPD (liability)", "form": "91X", "coverage": 1000000, "effective": "1993-03-01" }, { "insurer": "ACE AMERICAN INSURANCE COMPANY", "type": "BIPD (liability)", "form": "91X", "coverage": 2500000, "effective": "2025-12-31" }, { "insurer": "TRAVELERS CASUALTY & SURETY CO. OF AMERICA", "type": "Cargo", "form": "83", "coverage": 0, "effective": "2023-10-23" } ], "oosOrders": [], "inspections24m": { "inspections": 20172, "driverInspections": 20158, "driverOos": 145, "vehicleInspections": 11078, "vehicleOos": 2466, "driverOosRate": 0.7, "vehicleOosRate": 22.3 }, "crashes24m": { "crashes": 1472, "fatalCrashes": 44, "injuryCrashes": 494, "towawayCrashes": 934, "fatalities": 48, "injuries": 649 }, "suspensionNotices": [], "links": { "safer": "https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=80806", "sms": "https://ai.fmcsa.dot.gov/SMS/Carrier/80806/CarrierRegistration.aspx" } } ], "count": 2, "summary": { "carriers": 2, "doNotUse": 1, "review": 0, "clear": 1, "notFound": 0 }, "national24m": { "driverOosRate": 6.3, "vehicleOosRate": 22.8, "inspections": 5716888, "since": "2024-09-27" }, "note": "Riskiest first. Rules: do_not_use = inactive USDOT, active out-of-service order, interstate for-hire without active authority, or liability insurance below the required amount. review = new entrant (<90 days), pending or revocation-pending authority, missing cargo insurance/bond, suspension notice in 12 months, driver or vehicle OOS rate over 1.5x national, a fatal crash for a small fleet, or an MCS-150 older than 24 months. clear = none of these.", "sources": "FMCSA open data on data.transportation.gov: Company Census File, L&I Carrier/Insurance, Motus registrations, Out-of-Service Orders, Vehicle Inspection File, Crash File. FMCSA updates these daily; cached up to 6 hours.", "checkedAt": "2026-09-27T12:07:50.149Z" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (50/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "tags": [ "Haulroll API" ], "summary": "Vet up to 25 carriers by USDOT or MC number: verdict with FMCSA evidence", "description": "For each carrier: verdict (clear / review / do_not_use), a 0-100 risk score and the flags that applied; USDOT status, registration date and age, MCS-150 date, operation, entity, fleet size, drivers, cargo; operating authority (common, contract, broker, pending, revocation pending); liability insurance on file vs required, cargo and bond, insurers on file; out-of-service orders; 24-month inspections with driver and vehicle OOS rates next to the national rate; 24-month crashes; suspension notices; SAFER and SMS links. Riskiest first.", "operationId": "vetCarriersPost", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "carriers": { "type": "array", "items": { "type": "string" }, "maxItems": 25 } } }, "example": { "carriers": [ "80806", "MC681958" ] } } } }, "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "results": [ { "query": "USDOT 1185624", "status": "ok", "usdot": "1185624", "name": "LEE LOGISTIC", "verdict": { "level": "do_not_use", "riskScore": 100, "flags": [ { "level": "do_not_use", "code": "usdot_inactive", "text": "USDOT number status: Inactive" }, { "level": "do_not_use", "code": "no_active_authority", "text": "Interstate for-hire carrier without active operating authority" }, { "level": "do_not_use", "code": "insurance_below_required", "text": "Liability insurance on file $0 is below the required $750,000" }, { "level": "do_not_use", "code": "oos_order", "text": "Out-of-service order since 2026-09-01: New Entrant Revoked - Refusal of Audit/No Contact" }, { "level": "info", "code": "no_inspections", "text": "No roadside inspections in 24 months" } ] }, "carrier": { "usdot": "1185624", "legalName": null, "legalNameWithheld": true, "dbaName": "LEE LOGISTIC", "usdotStatus": "Inactive", "entity": [ "Carrier" ], "operation": "Interstate", "classification": [ "AUTHORIZED FOR HIRE" ], "city": "CHARLOTTE", "state": "NC", "zip": "28262", "country": "US", "registered": "2003-11-10", "ageDays": 8357, "mcs150Date": "2025-10-14", "mcs150AgeDays": 348, "mileage": 1, "mileageYear": 2024, "powerUnits": 1, "trucks": 1, "buses": 0, "drivers": 1, "cdlDrivers": 1, "hazmat": false, "cargo": [ "General freight", "Household goods" ], "docket": "MC479455" }, "authority": { "docket": "MC479455", "source": "FMCSA Licensing & Insurance", "common": "inactive", "contract": "none", "broker": "none", "type": "Property", "pendingApplication": false, "revocationPending": false, "bipdRequired": 750000, "bipdOnFile": 0, "cargoRequired": false, "cargoOnFile": false, "bondRequired": false, "bondOnFile": false }, "insurance": [], "oosOrders": [ { "date": "2026-09-01", "reason": "New Entrant Revoked - Refusal of Audit/No Contact", "rescinded": null, "active": true } ], "inspections24m": { "inspections": 0, "driverInspections": 0, "driverOos": 0, "vehicleInspections": 0, "vehicleOos": 0, "driverOosRate": null, "vehicleOosRate": null }, "crashes24m": { "crashes": 0, "fatalCrashes": 0, "injuryCrashes": 0, "towawayCrashes": 0, "fatalities": 0, "injuries": 0 }, "suspensionNotices": [], "links": { "safer": "https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=1185624", "sms": "https://ai.fmcsa.dot.gov/SMS/Carrier/1185624/CarrierRegistration.aspx" } }, { "query": "USDOT 80806", "status": "ok", "usdot": "80806", "name": "J B HUNT TRANSPORT INC", "verdict": { "level": "clear", "riskScore": 0, "flags": [] }, "carrier": { "usdot": "80806", "legalName": "J B HUNT TRANSPORT INC", "legalNameWithheld": false, "dbaName": "J B HUNT", "usdotStatus": "Active", "entity": [ "Freight forwarder", "Carrier", "Shipper", "Broker" ], "operation": "Interstate", "classification": [ "AUTHORIZED FOR HIRE" ], "city": "LOWELL", "state": "AR", "zip": "72745", "country": "US", "registered": "1974-06-01", "ageDays": 19111, "mcs150Date": "2025-07-07", "mcs150AgeDays": 447, "mileage": 1629835251, "mileageYear": 2024, "powerUnits": 25280, "trucks": 25280, "buses": 0, "drivers": 24116, "cdlDrivers": 23669, "hazmat": true, "cargo": [ "General freight", "Metal: sheets, coils, rolls", "Motor vehicles", "Logs, poles, beams, lumber", "Building materials", "Fresh produce", "Liquids/gases", "Intermodal containers", "Oilfield equipment", "Livestock", "Grain, feed, hay", "Meat", "US mail", "Chemicals", "Commodities dry bulk", "Refrigerated food", "Beverages", "Paper products", "Agricultural/farm supplies", "Construction", "Other: IEP" ], "docket": "MC135797" }, "authority": { "docket": "MC135797", "source": "FMCSA Licensing & Insurance", "common": "active", "contract": "active", "broker": "active", "type": "Property, Household goods, Broker", "pendingApplication": false, "revocationPending": false, "bipdRequired": 1000000, "bipdOnFile": 3500000, "cargoRequired": true, "cargoOnFile": true, "bondRequired": true, "bondOnFile": true }, "insurance": [ { "insurer": "TRAVELERS CASUALTY & SURETY CO. OF AMERICA", "type": "Bond", "form": "84", "coverage": 0, "effective": "2014-01-13" }, { "insurer": "SELF-INSURED", "type": "BIPD (liability)", "form": "91X", "coverage": 1000000, "effective": "1993-03-01" }, { "insurer": "ACE AMERICAN INSURANCE COMPANY", "type": "BIPD (liability)", "form": "91X", "coverage": 2500000, "effective": "2025-12-31" }, { "insurer": "TRAVELERS CASUALTY & SURETY CO. OF AMERICA", "type": "Cargo", "form": "83", "coverage": 0, "effective": "2023-10-23" } ], "oosOrders": [], "inspections24m": { "inspections": 20172, "driverInspections": 20158, "driverOos": 145, "vehicleInspections": 11078, "vehicleOos": 2466, "driverOosRate": 0.7, "vehicleOosRate": 22.3 }, "crashes24m": { "crashes": 1472, "fatalCrashes": 44, "injuryCrashes": 494, "towawayCrashes": 934, "fatalities": 48, "injuries": 649 }, "suspensionNotices": [], "links": { "safer": "https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=80806", "sms": "https://ai.fmcsa.dot.gov/SMS/Carrier/80806/CarrierRegistration.aspx" } } ], "count": 2, "summary": { "carriers": 2, "doNotUse": 1, "review": 0, "clear": 1, "notFound": 0 }, "national24m": { "driverOosRate": 6.3, "vehicleOosRate": 22.8, "inspections": 5716888, "since": "2024-09-27" }, "note": "Riskiest first. Rules: do_not_use = inactive USDOT, active out-of-service order, interstate for-hire without active authority, or liability insurance below the required amount. review = new entrant (<90 days), pending or revocation-pending authority, missing cargo insurance/bond, suspension notice in 12 months, driver or vehicle OOS rate over 1.5x national, a fatal crash for a small fleet, or an MCS-150 older than 24 months. clear = none of these.", "sources": "FMCSA open data on data.transportation.gov: Company Census File, L&I Carrier/Insurance, Motus registrations, Out-of-Service Orders, Vehicle Inspection File, Crash File. FMCSA updates these daily; cached up to 6 hours.", "checkedAt": "2026-09-27T12:07:50.149Z" } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (50/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/alerts": { "get": { "tags": [ "Haulroll API" ], "summary": "Monitor a carrier list: FMCSA events in the last N days", "description": "Out-of-service orders (and rescissions), authority suspension notices, authority status changes and liability/cargo insurance cancellations (including ones scheduled up to 60 days ahead) for up to 25 carriers, newest first with a severity. Empty = nothing new.", "operationId": "carrierAlertsGet", "parameters": [ { "name": "dot", "in": "query", "required": false, "description": "USDOT numbers and/or MC/MX/FF docket numbers, up to 25, separated by commas or spaces (or POST {\"carriers\": [...]})", "schema": { "type": "string" }, "example": "80806, MC681958" }, { "name": "days", "in": "query", "required": false, "description": "Look-back window in days (1-365)", "schema": { "type": "integer", "default": 30 }, "example": "30" } ], "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (50/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "tags": [ "Haulroll API" ], "summary": "Monitor a carrier list: FMCSA events in the last N days", "description": "Out-of-service orders (and rescissions), authority suspension notices, authority status changes and liability/cargo insurance cancellations (including ones scheduled up to 60 days ahead) for up to 25 carriers, newest first with a severity. Empty = nothing new.", "operationId": "carrierAlertsPost", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "carriers": { "type": "array", "items": { "type": "string" } }, "days": { "type": "integer" } } }, "example": { "carriers": [ "80806" ], "days": 30 } } } }, "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (50/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/new-carriers": { "get": { "tags": [ "Haulroll API" ], "summary": "New USDOT registrations: carriers FMCSA added in the last N days", "description": "Newest first, active USDOT numbers only, with city, state, ZIP, operation, fleet size, drivers, cargo and docket. Filters: state, cargo (general, household, metal, vehicles, towaway, logs, building, mobilehomes and more), hazmat, interstate, forHire. Company facts only (person-like names withheld).", "operationId": "newCarriersGet", "parameters": [ { "name": "state", "in": "query", "required": false, "description": "2-letter state code, e.g. TX", "schema": { "type": "string" }, "example": "TX" }, { "name": "days", "in": "query", "required": false, "description": "Look-back window in days (1-90)", "schema": { "type": "integer", "default": 7 }, "example": "7" }, { "name": "cargo", "in": "query", "required": false, "description": "Cargo class, e.g. general, reefer, household, vehicles, livestock, chemicals", "schema": { "type": "string" }, "example": "" }, { "name": "hazmat", "in": "query", "required": false, "description": "Only hazmat carriers", "schema": { "type": "boolean", "default": false } }, { "name": "interstate", "in": "query", "required": false, "description": "Only interstate carriers", "schema": { "type": "boolean", "default": false } }, { "name": "forHire", "in": "query", "required": false, "description": "Only authorized-for-hire carriers", "schema": { "type": "boolean", "default": false } }, { "name": "limit", "in": "query", "required": false, "description": "Rows to return (1-200)", "schema": { "type": "integer", "default": 50 } } ], "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (50/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "tags": [ "Haulroll API" ], "summary": "New USDOT registrations: carriers FMCSA added in the last N days", "description": "Newest first, active USDOT numbers only, with city, state, ZIP, operation, fleet size, drivers, cargo and docket. Filters: state, cargo (general, household, metal, vehicles, towaway, logs, building, mobilehomes and more), hazmat, interstate, forHire. Company facts only (person-like names withheld).", "operationId": "newCarriersPost", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "state": { "type": "string" }, "days": { "type": "integer" }, "cargo": { "type": "string" }, "hazmat": { "type": "boolean" }, "interstate": { "type": "boolean" }, "forHire": { "type": "boolean" }, "limit": { "type": "integer" } } }, "example": { "state": "TX", "days": 7 } } } }, "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (50/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "schemas": { "Error": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" }, "retryAfterSeconds": { "type": "integer" }, "limits": { "type": "object" } }, "required": [ "error", "message" ] } }, "securitySchemes": { "ApiKeyHeader": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "Optional. Paid plan key from https://haulroll-api.cybermax-tools.workers.dev/docs#pricing; leave out for the free tier." }, "BearerKey": { "type": "http", "scheme": "bearer", "description": "Same key as a Bearer token." } } }, "x-mcp-server": "https://haulroll-api.cybermax-tools.workers.dev/mcp", "externalDocs": { "description": "Get an API key (pricing)", "url": "https://haulroll-api.cybermax-tools.workers.dev/docs#pricing" }, "security": [ {}, { "ApiKeyHeader": [] }, { "BearerKey": [] } ] }