# FMCSA Carrier Intelligence (`sheshinmcfly/fmcsa-carrier-intelligence`) Actor Verify US trucking carriers before booking: operating authority, insurance status, out-of-service orders, and revocation history in one profile per DOT number, with a computed risk flag. Sourced from official DOT data, ideal for freight brokers and insurers. No login needed. - **URL**: https://apify.com/sheshinmcfly/fmcsa-carrier-intelligence.md - **Developed by:** [Sheshinmcfly](https://apify.com/sheshinmcfly) (community) - **Categories:** Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 carrier records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## FMCSA Carrier Intelligence Verify US trucking carriers before you book them. Look up any **DOT number** and get a combined profile: operating authority status, insurance on file, out-of-service orders, and revocation history — plus a computed risk flag. Sourced directly from official DOT data. No login, no API key, no subscription required. ### What data do you get? | Field | Type | Example | |---|---|---| | dotNumber, docketNumber | string | `02217388`, `MC012892` | | legalName, dbaName | string | registered business names | | businessStreet, businessCity, businessState, businessZip | string | registered address | | commonAuthorityStatus, contractAuthorityStatus, brokerAuthorityStatus | string | active/inactive per authority type | | propertyAuthority, passengerAuthority, householdGoodsAuthority | boolean | what the carrier is authorized to haul | | bipdInsuranceOnFile, cargoInsuranceOnFile, bondOnFile | boolean | insurance/bond currently on file | | bondRequired, cargoInsuranceRequired | boolean | what's required for this carrier | | **outOfService, oosDate, oosReason** | boolean, string | active FMCSA out-of-service orders | | **hasRevocationHistory, revocationType, revocationEffectiveDate** | boolean, string | authority revocation history | | **crashCount, crashFatalities, crashInjuries, mostRecentCrashDate** | number, string | reported crash history | | **phone, email** | string | direct contact on file | | **fleetSize, driverCount, hazmatCarrier** | number, number, boolean | fleet size, driver count, HAZMAT authorization | | **recentMileage, recentMileageYear, censusUpdatedDate** | number, number, string | latest self-reported mileage | | **riskFlags, riskLevel** | array, string | computed risk summary (LOW/MEDIUM/HIGH) | 46 fields per carrier, merged into a single record from multiple official DOT datasets. ### How to use 1. Open the actor and enter one or more DOT numbers 2. Click **Start** 3. Download results as JSON, CSV, or Excel ### Use cases - **Carrier vetting**: freight brokers and 3PLs verifying a carrier's authority and insurance before booking a load - **Insurance underwriting**: checking safety and compliance history before quoting a policy - **Compliance monitoring**: flagging carriers with active out-of-service orders or revocation history - **Fleet onboarding**: automating DOT number verification in a carrier onboarding workflow - **Risk scoring pipelines**: feeding the computed `riskLevel` and `riskFlags` into your own scoring models ### Input parameters ```json { "dotNumbers": ["02217388", "02217389"] } ```` | Parameter | Type | Required | Description | |---|---|---|---| | `dotNumbers` | array of strings | Yes | US DOT numbers to verify. | | `proxyConfiguration` | object | No | Optional — the actor works reliably without a proxy in most cases. | ### Example output (JSON) ```json { "dotNumber": "01000000", "docketNumber": "MC123456", "legalName": "EXAMPLE TRUCKING LLC", "dbaName": null, "businessCity": "PHENIX CITY", "businessState": "AL", "commonAuthorityStatus": "N", "brokerAuthorityStatus": "I", "propertyAuthority": true, "bipdInsuranceOnFile": false, "cargoInsuranceOnFile": false, "outOfService": false, "hasRevocationHistory": true, "revocationType": "INVOLUNTARY REVOCATION", "revocationEffectiveDate": "12/27/2005", "crashCount": 1, "crashFatalities": 0, "crashInjuries": 1, "mostRecentCrashDate": "1990-01-22", "phone": "(706) 325-1816", "email": "example@carrier.com", "fleetSize": 2, "driverCount": 2, "hazmatCarrier": false, "riskFlags": ["HAS_REVOCATION_HISTORY", "NO_LIABILITY_INSURANCE_ON_FILE"], "riskLevel": "HIGH", "extractedAt": "2026-07-09T21:03:16.964Z" } ``` ### Performance Returns results in a few seconds, even for larger batches of DOT numbers — data is retrieved efficiently regardless of list size. ### Pricing Pay-per-event: **$2.00 per 1,000 results** ($0.002 per carrier). Every Apify account gets $5 in free usage per month, enough to try this actor at no cost. ### Related actors - **[Congressional Stock Trades Scraper](https://apify.com/sheshinmcfly/congress-stock-trades-scraper)** — every House member stock trade disclosed under the STOCK Act. - **[SEC EDGAR Scraper](https://apify.com/sheshinmcfly/sec-edgar-scraper)** — company filings, Form 4 insider trades, XBRL financials and 13F fund holdings. - **[Zacks Rank Stock Scraper](https://apify.com/sheshinmcfly/zacks-rank-scraper)** — Zacks Rank (1-5 rating) plus a full quote snapshot for any US stock ticker. - **[ATS Job Board Scraper](https://apify.com/sheshinmcfly/ats-job-board-scraper)** — job postings from any company Greenhouse, Lever, or Ashby career page, unified in one schema. ### FAQ **Do I need an FMCSA account or subscription?** No. This actor extracts publicly available carrier data — no login required. **What does `riskLevel` mean?** A computed summary: `HIGH` if the carrier has an active out-of-service order or revocation history, `MEDIUM` if it's missing required insurance/bond, `LOW` otherwise. Always verify directly with the carrier before making a business decision. **What if a DOT number doesn't exist?** It's skipped with a warning rather than returned as an empty record — only valid, registered DOT numbers appear in your results. **How current is the data?** Sourced from the official DOT open-data mirror of FMCSA records, which is updated daily. ### Keywords FMCSA, DOT number lookup, carrier verification, trucking compliance, motor carrier safety, freight broker tools, carrier vetting, out of service orders, trucking insurance verification, logistics risk ### Legal Disclaimer This actor extracts publicly available carrier data published by the U.S. Department of Transportation. Users are solely responsible for ensuring their use of this data complies with applicable laws. This is not legal or compliance advice. ### Changelog - **v1.2 (2026-07-09)** — Added contact info (phone, email), fleet size, driver count, HAZMAT authorization, and recent mileage. - **v1.1 (2026-07-09)** — Added crash history (crashCount, crashFatalities, crashInjuries, mostRecentCrashDate) to the risk profile. - **v1.0 (2026-07-09)** — Initial release: combined FMCSA authority, insurance, out-of-service, and revocation data per DOT number, computed risk flags, no login required. # Actor input Schema ## `dotNumbers` (type: `array`): US DOT numbers to verify. ## `proxyConfiguration` (type: `object`): Optional — the actor works reliably without a proxy in most cases. ## Actor input object example ```json { "dotNumbers": [ "02217388", "02217389" ], "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `dataset` (type: `string`): All extracted carrier records stored in the default dataset. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "dotNumbers": [ "02217388", "02217389" ] }; // Run the Actor and wait for it to finish const run = await client.actor("sheshinmcfly/fmcsa-carrier-intelligence").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "dotNumbers": [ "02217388", "02217389", ] } # Run the Actor and wait for it to finish run = client.actor("sheshinmcfly/fmcsa-carrier-intelligence").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "dotNumbers": [ "02217388", "02217389" ] }' | apify call sheshinmcfly/fmcsa-carrier-intelligence --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sheshinmcfly/fmcsa-carrier-intelligence", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "FMCSA Carrier Intelligence", "description": "Verify US trucking carriers before booking: operating authority, insurance status, out-of-service orders, and revocation history in one profile per DOT number, with a computed risk flag. Sourced from official DOT data, ideal for freight brokers and insurers. No login needed.", "version": "0.1", "x-build-id": "3yNX0OWAWcZstiaUn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sheshinmcfly~fmcsa-carrier-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sheshinmcfly-fmcsa-carrier-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sheshinmcfly~fmcsa-carrier-intelligence/runs": { "post": { "operationId": "runs-sync-sheshinmcfly-fmcsa-carrier-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sheshinmcfly~fmcsa-carrier-intelligence/run-sync": { "post": { "operationId": "run-sync-sheshinmcfly-fmcsa-carrier-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "dotNumbers" ], "properties": { "dotNumbers": { "title": "DOT numbers", "type": "array", "description": "US DOT numbers to verify.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional — the actor works reliably without a proxy in most cases.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```