{ "openapi": "3.0.1", "info": { "title": "FMCSA Carrier Data: USDOT & MC Lookup, Insurance, New Carriers", "description": "Look up and search US trucking companies and brokers in official FMCSA data: USDOT/MC, authority, insurer, insurance history and upcoming cancellations, safety, phone, email. Daily feed of new and revoked authority, radius search near any ZIP, free lead score and monitor alerts.", "version": "0.2", "x-build-id": "xidTPkGdwNxfONmPC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cleanyield~fmcsa-carrier-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cleanyield-fmcsa-carrier-data", "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/cleanyield~fmcsa-carrier-data/runs": { "post": { "operationId": "runs-sync-cleanyield-fmcsa-carrier-data", "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/cleanyield~fmcsa-carrier-data/run-sync": { "post": { "operationId": "run-sync-cleanyield-fmcsa-carrier-data", "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", "properties": { "dotNumbers": { "title": "USDOT numbers (bulk lookup)", "type": "array", "description": "USDOT numbers to look up, one per line (leading zeros and 'USDOT' prefixes are fine). Example: 80806. When you give USDOT or MC numbers, the search filters below are ignored and every number is returned regardless of status. Numbers that don't exist are reported in the log and never charged.", "items": { "type": "string" } }, "mcNumbers": { "title": "MC / FF / MX docket numbers (bulk lookup)", "type": "array", "description": "Operating authority docket numbers, one per line. Accepts 'MC-135797', 'MC135797', 'FF51075' or just '135797' (MC is assumed). Example: MC-135797.", "items": { "type": "string" } }, "states": { "title": "States", "type": "array", "description": "Physical (domicile) state of the company: 2-letter codes or full names. Example: TX, OK. Leave empty for all states.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Physical city names (exact match, case-insensitive). Combine with States to avoid same-name cities elsewhere. Example: Dallas.", "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes or prefixes", "type": "array", "description": "Physical ZIP codes (5 digits) or prefixes (3–4 digits match a whole area). Example: 75201 or 752.", "items": { "type": "string" } }, "nearLocation": { "title": "Near a ZIP or city (radius search)", "type": "string", "description": "Find carriers based within a radius of a 5-digit ZIP (75201) or a city with its state (Dallas, TX). Uses US Census ZIP centroids, no extra cost. Each result gets distanceMiles. Combine with any filter below (fleet size, cargo, new carriers...)." }, "radiusMiles": { "title": "Radius (miles)", "minimum": 1, "maximum": 300, "type": "integer", "description": "Radius around 'Near a ZIP or city', 1 to 300 miles. Default 50.", "default": 50 }, "nameContains": { "title": "Company name contains", "type": "string", "description": "Optional text that must appear in the legal name or DBA name (case-insensitive). Example: logistics." }, "entityTypes": { "title": "Entity types", "type": "array", "description": "Keep only entities registered as any of these types (FMCSA 'carship' field). Example: carrier for trucking companies, broker for freight brokers. Leave empty for all.", "items": { "type": "string", "enum": [ "carrier", "broker", "freightForwarder", "shipper", "intermodalEquipmentProvider", "cargoTankFacility", "registrant" ], "enumTitles": [ "Carrier (trucking company)", "Broker", "Freight forwarder", "Shipper", "Intermodal equipment provider", "Cargo tank facility", "Registrant" ] } }, "operationType": { "title": "Operation type", "enum": [ "any", "interstate", "intrastate", "intrastateHazmat", "intrastateNonHazmat" ], "type": "string", "description": "Interstate (crosses state lines, most for-hire trucking) or intrastate carriers. Example: interstate.", "default": "any" }, "authorizedForHireOnly": { "title": "Only authorized for-hire carriers", "type": "boolean", "description": "Keep only companies whose operation classification includes 'Authorized for hire' (they haul freight for others — the ones brokers book and insurers quote). Excludes private fleets.", "default": false }, "hazmat": { "title": "Hazmat", "enum": [ "any", "only", "exclude" ], "type": "string", "description": "Filter by the hazardous-materials flag. Example: only (hazmat carriers only).", "default": "any" }, "cargoTypes": { "title": "Cargo carried", "type": "array", "description": "Keep carriers that haul any of these cargo types (as declared on their MCS-150). Example: refrigeratedFood for reefer carriers.", "items": { "type": "string", "enum": [ "generalFreight", "householdGoods", "metalSheetsCoilsRolls", "motorVehicles", "driveTowAway", "logsPolesBeamsLumber", "buildingMaterials", "mobileHomes", "machineryLargeObjects", "freshProduce", "liquidsGases", "intermodalContainers", "passengers", "oilfieldEquipment", "livestock", "grainFeedHay", "coalCoke", "meat", "garbageRefuse", "usMail", "chemicals", "commoditiesDryBulk", "refrigeratedFood", "beverages", "paperProducts", "utilities", "agriculturalFarmSupplies", "construction", "waterWell", "other" ], "enumTitles": [ "General Freight", "Household Goods", "Metal: sheets, coils, rolls", "Motor Vehicles", "Drive/Tow away", "Logs, Poles, Beams, Lumber", "Building Materials", "Mobile Homes", "Machinery, Large Objects", "Fresh Produce", "Liquids/Gases", "Intermodal Containers", "Passengers", "Oilfield Equipment", "Livestock", "Grain, Feed, Hay", "Coal/Coke", "Meat", "Garbage/Refuse", "US Mail", "Chemicals", "Commodities Dry Bulk", "Refrigerated Food", "Beverages", "Paper Products", "Utilities", "Agricultural/Farm Supplies", "Construction", "Water Well", "Other" ] } }, "minPowerUnits": { "title": "Minimum power units (trucks)", "minimum": 0, "type": "integer", "description": "Minimum number of power units (trucks/tractors) reported on the MCS-150. Example: 5." }, "maxPowerUnits": { "title": "Maximum power units (trucks)", "minimum": 0, "type": "integer", "description": "Maximum number of power units. Example: 1 for owner-operators, 10 for small fleets." }, "minDrivers": { "title": "Minimum drivers", "minimum": 0, "type": "integer", "description": "Minimum total drivers reported on the MCS-150. Example: 2." }, "maxDrivers": { "title": "Maximum drivers", "minimum": 0, "type": "integer", "description": "Maximum total drivers. Example: 20." }, "addedWithinDays": { "title": "Added in the last N days", "minimum": 1, "maximum": 36500, "type": "integer", "description": "Only companies whose USDOT number was added (registered) in the last N days — relative to each run, ideal for scheduled 'new carriers' feeds. Example: 30. FMCSA publishes new registrations with a 1–2 day delay." }, "addedSince": { "title": "Added on or after (date)", "type": "string", "description": "Only companies registered (USDOT add date) on or after this date, YYYY-MM-DD. Example: 2026-10-01. If 'Added in the last N days' is also set, the more recent date wins." }, "addedBefore": { "title": "Added on or before (date)", "type": "string", "description": "Only companies registered on or before this date, YYYY-MM-DD. Example: 2026-10-31." }, "mcs150UpdatedSince": { "title": "MCS-150 updated since (date)", "type": "string", "description": "Only companies that filed or updated their MCS-150 registration form on or after this date, YYYY-MM-DD. Example: 2026-09-01 (recently active companies)." }, "usdotStatus": { "title": "USDOT status", "enum": [ "active", "inactive", "pending", "any" ], "type": "string", "description": "Registration status of the USDOT number. Default: active (operating companies). Not applied to USDOT/MC lookups.", "default": "active" }, "authorityStatus": { "title": "Operating authority (MC)", "enum": [ "any", "active", "none" ], "type": "string", "description": "Filter by operating authority: 'active' = has an active MC/FF/MX authority (for-hire interstate carriers and brokers); 'none' = no authority docket (private fleets, intrastate).", "default": "any" }, "safetyRatings": { "title": "Safety ratings", "type": "array", "description": "Keep only these FMCSA safety ratings. Most carriers are 'unrated'. Example: conditional, unsatisfactory (to vet risky carriers).", "items": { "type": "string", "enum": [ "satisfactory", "conditional", "unsatisfactory", "unrated" ], "enumTitles": [ "Satisfactory", "Conditional", "Unsatisfactory", "Not rated" ] } }, "requireEmail": { "title": "Only with email", "type": "boolean", "description": "Keep only companies that published an email address on their FMCSA registration.", "default": false }, "requirePhone": { "title": "Only with phone", "type": "boolean", "description": "Keep only companies that published a phone number.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "newest", "largestFleet", "recentlyUpdated", "dotNumber" ], "type": "string", "description": "Order of the search results. Newest = most recently registered first.", "default": "newest" }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Search mode: stop after this many carriers. Use it to cap your cost: you pay only for results actually returned. USDOT/MC lookups always return every number you list. Example: 1000.", "default": 100 }, "maxResultsPerState": { "title": "Max results per state", "minimum": 0, "type": "integer", "description": "Optional cap per state when you select several states (e.g. 200 per state). 0 or empty = no per-state cap (maxResults still caps the whole run)." }, "authorityEvents": { "title": "Authority events (new authority, revocations...)", "type": "array", "description": "Daily feed from FMCSA's authority history: get the carriers and brokers whose operating authority was GRANTED, newly applied for (pending), reinstated, suspended, revoked, withdrawn or put out of service in the last N days, with the event in authorityEvent. Combine with state, radius, fleet and cargo filters. Schedule it daily with monitor mode to get only the new ones.", "items": { "type": "string", "enum": [ "granted", "pending", "reinstated", "suspended", "revoked", "withdrawn", "outOfService" ], "enumTitles": [ "Granted (new authority)", "Pending (new application)", "Reinstated", "Suspended", "Revoked / inactivated", "Withdrawn", "Out of service" ] } }, "authorityEventsWithinDays": { "title": "Events in the last N days", "minimum": 0, "maximum": 365, "type": "integer", "description": "How far back to read authority events. 1 = yesterday and today (for a daily schedule). Default 7, max 365.", "default": 7 }, "includeAuthority": { "title": "Include operating authority details", "type": "boolean", "description": "Add out-of-service order status, each carrier's operating authorities (type and status per MC docket) and insurance requirements vs. on file (BIPD amount, cargo, bond), from FMCSA's Motus and L&I datasets. Free, adds ~1 s per 150 carriers.", "default": true }, "includeInsurance": { "title": "Include insurance policies", "type": "boolean", "description": "Add active/pending insurance filings: insurer, policy number, coverage, effective date (renewal timing for insurance agents) and pending cancellation date when published.", "default": true }, "includeInsuranceHistory": { "title": "Include insurance history and upcoming cancellations", "type": "boolean", "description": "Cancelled and replaced policies (insurer, policy, dates), the next cancellation already filed with a future date, and cancellations in the last 12 months. Free.", "default": true }, "includeSafety": { "title": "Include inspections, out-of-service rates and crashes (24 months)", "type": "boolean", "description": "Add the SAFER-style safety block: roadside inspections (vehicle/driver), out-of-service counts and rates, crashes (fatal/injury/tow-away) for the last 24 months and the 5 public BASIC measures, from FMCSA's monthly SMS snapshot. No extra charge.", "default": true }, "checkSharedContacts": { "title": "Flag shared phones and emails", "type": "boolean", "description": "Count how many USDOT records use the same phone and email. 10 or more (typically a permit or compliance agent, sometimes a company's own subsidiaries) sets phoneIsShared/emailIsShared so you can skip agent contacts. No extra charge.", "default": true }, "contactData": { "title": "Contact data", "enum": [ "include", "omitForIndividuals", "omit" ], "type": "string", "description": "FMCSA publishes the phone and email each company gives for official contact. Choose 'omitForIndividuals' to drop phone/email of sole proprietors (owner-operators registered as individuals), or 'omit' to drop all contact data. Outreach is subject to TCPA and CAN-SPAM.", "default": "include" }, "includeOfficerNames": { "title": "Include company officer names", "type": "boolean", "description": "Add the names of up to 2 company officers listed on the MCS-150 (personal data: off by default).", "default": false }, "includeRawData": { "title": "Include the raw census row", "type": "boolean", "description": "Attach every column of the FMCSA Company Census (140+ fields, exactly as filed) in rawCensus. Bigger output; no extra charge.", "default": false }, "outputFormat": { "title": "Output format", "enum": [ "standard", "leader-compatible" ], "type": "string", "description": "leader-compatible adds (never replaces) the field names used by other popular FMCSA scrapers (mcNumber, registrationDate, authorityGrantedDate, currentlyOutOfService, saferSnapshotUrl, cargoTypes, totalDrivers, cellPhone...), so you can switch without changing your integration. See 'Migrating from other scrapers' in the README.", "default": "standard" }, "socrataAppToken": { "title": "Socrata app token (optional)", "type": "string", "description": "Optional free app token from data.transportation.gov (Developer settings) for higher API quota on very large runs. Not needed for normal use: the Actor paces its requests politely without one. E.g. the app token string shown in your data.transportation.gov developer settings." }, "monitorMode": { "title": "Monitor mode (only new or changed carriers)", "type": "boolean", "description": "For scheduled runs: remember what was found last time and output only carriers that are new or changed since the previous run (authority, insurance, fleet size, phone/email, address, name, safety rating). Each item gets changeType (new/changed) and a field-by-field changes list. You pay only for new/changed carriers. Schedule the Actor daily or weekly.", "default": false }, "monitorStateName": { "title": "Monitor state name", "type": "string", "description": "Optional name of the storage that keeps the previous results. Use the same name across scheduled runs to compare against them. Leave empty to derive it automatically from the rest of the input. Lowercase letters, numbers and hyphens only. Example: tx-new-carriers." }, "notifyWebhookUrl": { "title": "Webhook URL for alerts", "type": "string", "description": "Optional. When monitor mode finds new or changed carriers, POST a JSON summary to this URL (works with Zapier, Make, n8n). Example: https://hooks.zapier.com/hooks/catch/123/abc" }, "notifySlackWebhookUrl": { "title": "Slack webhook URL for alerts", "type": "string", "description": "Optional. Slack incoming-webhook URL to receive a message listing new and changed carriers. Example: https://hooks.slack.com/services/T000/B000/XXXX" }, "savedListName": { "title": "Saved watchlist name", "type": "string", "description": "Give your USDOT/MC list a name (e.g. my-carriers) and the Actor remembers it: next runs use the saved list plus any numbers you add. Pair it with Monitor mode for a carrier watchlist." }, "saveList": { "title": "Save new numbers to the list", "type": "boolean", "description": "Add the USDOT/MC numbers of this run to the saved list (off = use the saved list without changing it).", "default": true }, "proMode": { "title": "Pro mode (risk score, insurance renewal, why-now, trend, AI summary)", "type": "boolean", "description": "One checkbox for all the extras: a 0-100 carrier risk score with its reasons, estimated insurance renewal date, a dated 'why now' line for sales outreach, the trend since you started monitoring (fleet, crashes, out-of-service rate) and a one-sentence AI summary per carrier. In monitor mode it also alerts on safety changes. Charged as an extra 'pro-result' event per carrier (see Pricing).", "default": false }, "enrichCompanyWebsite": { "title": "Add company website contacts", "type": "boolean", "description": "For carriers whose email uses their own domain (not Gmail/Yahoo...), read the company website and add its emails, phones, contact page, social profiles, technologies and hiring status in companyWebsite. Slower (a few seconds per website). Charged as an extra 'company-website' event only when the website is read successfully.", "default": 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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }