{ "openapi": "3.0.1", "info": { "title": "New Trucking Companies: FMCSA Leads, DOT & MC Number Lookup", "description": "Find new trucking companies: FMCSA new motor carriers registered in the last N days by state, with phone and e-mail where filed. DOT number lookup (USDOT) and MC number lookup with authority, insurance, fleet size, cargo and hazmat filters. Official Company Census, daily data. Pay per carrier.", "version": "0.1", "x-build-id": "6aGaZZ3mcSUL5L6J7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidfetch~fmcsa-carriers/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidfetch-fmcsa-carriers", "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/solidfetch~fmcsa-carriers/runs": { "post": { "operationId": "runs-sync-solidfetch-fmcsa-carriers", "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/solidfetch~fmcsa-carriers/run-sync": { "post": { "operationId": "run-sync-solidfetch-fmcsa-carriers", "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": { "newCarriersSince": { "title": "New carriers since", "type": "string", "description": "Only carriers whose census record was added on or after this date, newest first. Pick a date or a period such as \"7 days\". FMCSA also re-dates a record when a carrier is reactivated, so a few older companies appear too. The dataset is refreshed once a day and usually lags one day." }, "states": { "title": "States", "type": "array", "description": "Physical address state, two-letter codes such as TX, CA or ON, or US state names. Empty means all states.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Physical address city, matched exactly but without regard to case, for example Dallas. Combine with a state, since many city names repeat.", "items": { "type": "string" } }, "carrierOperations": { "title": "Carrier operation", "type": "array", "description": "Interstate, or intrastate with or without hazardous materials. Empty means all.", "items": { "type": "string", "enum": [ "interstate", "intrastateHazmat", "intrastateNonHazmat" ], "enumTitles": [ "Interstate", "Intrastate, hazmat", "Intrastate, non-hazmat" ] } }, "authorizedForHireOnly": { "title": "Only for-hire carriers", "type": "boolean", "description": "Keep carriers classified as Authorized For Hire, which haul other people's freight. Private fleets that only move their own goods are dropped.", "default": false }, "minPowerUnits": { "title": "Min power units", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Fleet size from the MCS-150 form: trucks, tractors and buses. Carriers without a number are dropped when you set a range." }, "maxPowerUnits": { "title": "Max power units", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Upper end of the fleet size range." }, "minDrivers": { "title": "Min drivers", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Total drivers reported by the carrier." }, "maxDrivers": { "title": "Max drivers", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Upper end of the driver range." }, "cargoTypes": { "title": "Cargo types", "type": "array", "description": "Keep carriers that haul any of these cargo types. Empty means all.", "items": { "type": "string", "enum": [ "generalFreight", "householdGoods", "metalSheetsCoilsRolls", "motorVehicles", "driveawayTowaway", "logsPolesLumber", "buildingMaterials", "mobileHomes", "machineryLargeObjects", "freshProduce", "liquidsGases", "intermodalContainers", "passengers", "oilfieldEquipment", "livestock", "grainFeedHay", "coalCoke", "meat", "garbageRefuse", "usMail", "chemicals", "dryBulk", "refrigeratedFood", "beverages", "paperProducts", "utility", "farmSupplies", "construction", "waterWell", "other" ], "enumTitles": [ "General Freight", "Household Goods", "Metal: Sheets, Coils, Rolls", "Motor Vehicles", "Driveaway/Towaway", "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, Trash", "U.S. Mail", "Chemicals", "Commodities Dry Bulk", "Refrigerated Food", "Beverages", "Paper Products", "Utility", "Farm Supplies", "Construction", "Water Well", "Other" ] } }, "hazmat": { "title": "Hazardous materials", "enum": [ "any", "only", "exclude" ], "type": "string", "description": "Filter on the FMCSA hazmat flag.", "default": "any" }, "activeOnly": { "title": "Only active carriers", "type": "boolean", "description": "Skip inactive records. Lookups by number always return the record, active or not.", "default": true }, "requireEmail": { "title": "Only with an e-mail", "type": "boolean", "description": "Skip carriers without an e-mail address in the output. Sole proprietors, whose e-mail is hidden by default, are skipped too and not charged.", "default": false }, "requireMcNumber": { "title": "Only with an MC or MX number", "type": "boolean", "description": "Keep carriers that have an MC or MX docket number in the FMCSA census. Newly added carriers mostly have no MC number there yet, so combined with the new-carriers date filter this returns few or no rows. The pending MC numbers from the operating authority files are not used by this filter.", "default": false }, "dotNumbers": { "title": "USDOT numbers", "type": "array", "description": "Look up these carriers instead of searching. Forms like 53467, USDOT 53467 or DOT# 53467 work. Up to 10,000 numbers per run, returned in the same order.", "items": { "type": "string" } }, "mcNumbers": { "title": "MC, MX or FF numbers", "type": "array", "description": "Look up carriers by docket number: MC-138328, MX-231168, FF-4624, or just the digits. Plain digits mean MC, or the MX or FF docket with those digits when there is no MC one. One docket can belong to several carriers. All of them are returned, the active holder first.", "items": { "type": "string" } }, "includeContactsForSoleProprietors": { "title": "Include e-mail and street of sole proprietors", "type": "boolean", "description": "Carriers that look like individuals come without phone, e-mail and street address by default, because those are a person's private contacts. Turn this on only if you have a lawful basis to process personal data (see Personal data in the README).", "default": false }, "includeAuthority": { "title": "Include operating authority", "type": "boolean", "description": "Add the carrier's operating authority from the FMCSA licensing files: every MC, MX and FF docket with its authority type and status (active, pending application, inactive, withdrawn), since when and why for authorities that are not active (revoked, suspended), and the liability, cargo and bond insurance on file. New carriers get their pending MC number. One extra request per page of up to 800 carriers, plus one when a carrier on the page has an authority that is not active. No extra charge.", "default": true }, "includeInsurance": { "title": "Include insurance policies", "type": "boolean", "description": "Add the policies on file (insurer, type, primary or excess, coverage amount, effective date) and the carrier's most recent cancelled policies with their cancellation dates. Two more requests per page, so it is off by default. No extra charge.", "default": false }, "insuranceFilter": { "title": "Insurance leads", "enum": [ "any", "leadsOnly", "insuredOnly" ], "type": "string", "description": "Keep only carriers that need insurance, or only carriers that have it. Needs Include operating authority and Include insurance policies turned on. Carriers left out are not saved and not charged. The rule is in the README under Leads for insurance agents.", "default": "any" }, "maxItems": { "title": "Max carriers", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after this many carriers. You pay per carrier saved. Empty means 100 for a search and every carrier found for a lookup." } } }, "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 } } } } } } } } } }