{ "openapi": "3.0.1", "info": { "title": "FMCSA Carrier Leads – Trucking Companies & Freight Brokers List", "description": "FMCSA carrier leads from official DOT open data: trucking companies & freight brokers by state, city, fleet size, cargo, authority status. DOT/MC number, name, address, phone, email, power units, drivers, safety rating, authority dates.", "version": "0.1", "x-build-id": "pGPD15YRgH2dOOab9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dedicated_crest~fmcsa-trucking-carrier-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dedicated_crest-fmcsa-trucking-carrier-leads", "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/dedicated_crest~fmcsa-trucking-carrier-leads/runs": { "post": { "operationId": "runs-sync-dedicated_crest-fmcsa-trucking-carrier-leads", "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/dedicated_crest~fmcsa-trucking-carrier-leads/run-sync": { "post": { "operationId": "run-sync-dedicated_crest-fmcsa-trucking-carrier-leads", "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": { "states": { "title": "States", "type": "array", "description": "2-letter state codes of the company's physical address, e.g. TX, CA.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "City names, optionally with state: \"Dallas, TX\".", "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes / prefixes", "type": "array", "description": "5-digit ZIPs or prefixes (e.g. 752 matches 75201–75299).", "items": { "type": "string" } }, "dotNumbers": { "title": "USDOT numbers (lookup)", "type": "array", "description": "Look up specific USDOT numbers (DOT number lookup / list enrichment).", "items": { "type": "string" } }, "mcNumbers": { "title": "MC / MX / FF docket numbers (lookup)", "type": "array", "description": "Look up companies by MC number, e.g. MC150578 or 150578.", "items": { "type": "string" } }, "nameContains": { "title": "Name contains", "type": "string", "description": "Text in the legal or DBA name, e.g. LOGISTICS." }, "entityType": { "title": "Entity type", "enum": [ "any", "carrier", "broker", "carrier_and_broker", "freight_forwarder", "shipper" ], "type": "string", "description": "Registered entity type from the census.", "default": "any" }, "operationTypes": { "title": "Operation type", "type": "array", "description": "Carrier operation. Empty = all.", "items": { "type": "string", "enum": [ "interstate", "intrastate_hazmat", "intrastate_non_hazmat" ], "enumTitles": [ "Interstate", "Intrastate hazmat", "Intrastate non-hazmat" ] } }, "classification": { "title": "Operation classification", "enum": [ "any", "for_hire", "private_property", "exempt_for_hire", "private_passenger" ], "type": "string", "description": "MCS-150 operation classification.", "default": "any" }, "usdotStatus": { "title": "USDOT status", "enum": [ "active", "inactive", "any" ], "type": "string", "description": "USDOT registration status.", "default": "active" }, "authorityStatus": { "title": "Operating authority (MC) status", "enum": [ "any", "active", "broker_active", "pending", "none" ], "type": "string", "description": "Filter by FMCSA Licensing & Insurance authority status. Applied after the census query, so narrow searches run faster.", "default": "any" }, "minPowerUnits": { "title": "Min power units (fleet size)", "minimum": 0, "type": "integer", "description": "Minimum trucks/tractors (power units)." }, "maxPowerUnits": { "title": "Max power units", "minimum": 0, "type": "integer", "description": "Maximum power units, e.g. 10 for small fleets / owner-operators." }, "minDrivers": { "title": "Min drivers", "minimum": 0, "type": "integer", "description": "Minimum total drivers." }, "maxDrivers": { "title": "Max drivers", "minimum": 0, "type": "integer", "description": "Maximum total drivers." }, "cargoTypes": { "title": "Cargo types (any of)", "type": "array", "description": "Cargo carried (MCS-150). Matches companies hauling any selected cargo.", "items": { "type": "string", "enum": [ "general_freight", "household_goods", "metal_sheets_coils_rolls", "motor_vehicles", "drive_tow_away", "logs_poles_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", "dry_bulk", "refrigerated_food", "beverages", "paper_products", "utilities", "agricultural_farm_supplies", "construction", "water_well", "other" ], "enumTitles": [ "General Freight", "Household Goods", "Metal Sheets Coils Rolls", "Motor Vehicles", "Drive Tow Away", "Logs Poles 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", "Dry Bulk", "Refrigerated Food", "Beverages", "Paper Products", "Utilities", "Agricultural Farm Supplies", "Construction", "Water Well", "Other" ] } }, "hazmatOnly": { "title": "Hazmat carriers only", "type": "boolean", "description": "Only carriers flagged as hazardous-materials carriers.", "default": false }, "safetyRatings": { "title": "Safety rating", "type": "array", "description": "FMCSA safety rating. Empty = all.", "items": { "type": "string", "enum": [ "satisfactory", "conditional", "unsatisfactory", "not_rated" ], "enumTitles": [ "Satisfactory", "Conditional", "Unsatisfactory", "Not rated" ] } }, "addedAfter": { "title": "USDOT added on/after", "type": "string", "description": "Only companies whose USDOT number was added on/after this date (new carriers). YYYY-MM-DD." }, "addedBefore": { "title": "USDOT added on/before", "type": "string", "description": "Only companies added on/before this date." }, "requirePhone": { "title": "Only with phone", "type": "boolean", "description": "Skip records without a phone number.", "default": false }, "requireEmail": { "title": "Only with email", "type": "boolean", "description": "Skip records without a public email in the census.", "default": false }, "includeAuthorityData": { "title": "Include authority status & history", "type": "boolean", "description": "Join FMCSA L&I authority status, insurance on file and authority grant/revocation dates.", "default": true }, "maxItems": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Maximum companies to return (0 = no limit). The run also stops cleanly at your max charge per run.", "default": 1000 } } }, "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 } } } } } } } } } }