{ "openapi": "3.0.1", "info": { "title": "FMCSA Biennial Update (MCS-150) Due & Overdue Carrier Leads", "description": "Trucking and bus companies whose FMCSA biennial update (MCS-150) is due this month or next, or already overdue, worked out from the official USDOT filing schedule and FMCSA's daily census. One row per carrier with deadline, last MCS-150 date, phone, email, address, fleet and authority. No API key.", "version": "0.1", "x-build-id": "IhngW8ncb6QkzQJKs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/intenal_builds~fmcsa-biennial-update-due-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-intenal_builds-fmcsa-biennial-update-due-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/intenal_builds~fmcsa-biennial-update-due-leads/runs": { "post": { "operationId": "runs-sync-intenal_builds-fmcsa-biennial-update-due-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/intenal_builds~fmcsa-biennial-update-due-leads/run-sync": { "post": { "operationId": "run-sync-intenal_builds-fmcsa-biennial-update-due-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": { "segments": { "title": "Segments", "type": "array", "description": "due = biennial deadline in the chosen month(s) and no MCS-150 filed in that deadline's calendar year yet. overdue = most recent deadline has passed with no MCS-150 dated in that year or later (USDOT deactivation risk).", "items": { "type": "string", "enum": [ "due", "overdue" ], "enumTitles": [ "Due (upcoming deadline)", "Overdue (missed deadline)" ] }, "default": [ "due" ] }, "nextDeadlines": { "title": "Upcoming deadline months", "minimum": 1, "maximum": 10, "type": "integer", "description": "For the due segment: how many upcoming deadline months to include, starting with the current month. Deadlines only fall January to October, so November and December are skipped. Ignored when Deadline months is set.", "default": 1 }, "deadlineMonths": { "title": "Deadline months (YYYY-MM)", "type": "array", "description": "For the due segment: exact deadline months, e.g. 2027-01. January to October only.", "items": { "type": "string" } }, "overdueMaxMonthsSinceUpdate": { "title": "Overdue: max months since last MCS-150", "minimum": 0, "maximum": 600, "type": "integer", "description": "For the overdue segment: only carriers whose last MCS-150 is at most this many months old (recent lapses, more likely still operating). 0 = no limit.", "default": 36 }, "skipUpdatedWithinMonths": { "title": "Skip carriers updated within N months", "minimum": 0, "maximum": 60, "type": "integer", "description": "Extra filter: drop carriers whose last MCS-150 is newer than N months. 0 = off.", "default": 0 }, "states": { "title": "States", "type": "array", "description": "Two-letter physical-address states, e.g. TX, OK. Empty = all.", "items": { "type": "string" } }, "carrierOperation": { "title": "Carrier operation", "type": "array", "description": "A = interstate, B = intrastate hazmat, C = intrastate non-hazmat. Empty = all.", "items": { "type": "string", "enum": [ "A", "B", "C" ], "enumTitles": [ "Interstate", "Intrastate hazmat", "Intrastate non-hazmat" ] } }, "forHireOnly": { "title": "Authorized for-hire only", "type": "boolean", "description": "Only carriers classified as Authorized For Hire.", "default": false }, "requireOperatingAuthority": { "title": "Has an MC/FF/MX docket", "type": "boolean", "description": "Only carriers with an operating authority docket number.", "default": false }, "hazmatOnly": { "title": "Hazmat carriers only", "type": "boolean", "description": "Only carriers flagged as hazmat carriers.", "default": false }, "passengerCarriersOnly": { "title": "Passenger carriers only", "type": "boolean", "description": "Carriers with buses or that haul passengers.", "default": false }, "cargoTypes": { "title": "Cargo types", "type": "array", "description": "Any of: General Freight, Household Goods, Fresh Produce, Refrigerated Food, Livestock, Chemicals, Intermodal Containers, Motor Vehicles, Machinery/Large Objects, Oilfield Equipment, Grain/Feed/Hay, Building Materials, Logs/Poles/Beams/Lumber, Liquids/Gases, Passengers, US Mail, Beverages, Paper Products, Commodities Dry Bulk, Garbage/Refuse, Coal/Coke, Meat, Metal/Sheets/Coils/Rolls, Mobile Homes, Drive/Tow Away, Utilities, Agricultural/Farm Supplies, Construction, Water Well. Empty = all.", "items": { "type": "string" } }, "minPowerUnits": { "title": "Min power units", "minimum": 0, "type": "integer", "description": "Minimum power units (tractors/trucks/buses)." }, "maxPowerUnits": { "title": "Max power units", "minimum": 0, "type": "integer", "description": "Maximum power units. Use 1-10 to target small fleets." }, "minDrivers": { "title": "Min drivers", "minimum": 0, "type": "integer", "description": "Minimum total drivers." }, "requirePhone": { "title": "Phone required", "type": "boolean", "description": "Only carriers with a valid 10-digit phone on file.", "default": true }, "requireEmail": { "title": "Email required", "type": "boolean", "description": "Only carriers with an email on file.", "default": false }, "excludeIndividuals": { "title": "Skip carriers registered as INDIVIDUAL", "type": "boolean", "description": "Skip rows FMCSA marks with business type INDIVIDUAL (organization-level leads only).", "default": true }, "businessNamesOnly": { "title": "Business names only", "type": "boolean", "description": "Keep only carriers whose legal name contains a business word (INC, LLC, CORP, TRUCKING, TRANSPORT, LOGISTICS, FARMS, SERVICES, ...). Drops person-named sole proprietors so every row is an organization.", "default": true }, "dotNumbers": { "title": "USDOT watch list", "type": "array", "description": "Only check these USDOT numbers (e.g. your own customers or carriers you broker loads to).", "items": { "type": "string" } }, "sortBy": { "title": "Sort", "enum": [ "fleet_size_desc", "oldest_update_first", "dot_number" ], "type": "string", "description": "Order of results within each segment.", "default": "fleet_size_desc" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many carriers. The run also stops when your max charge per run is reached.", "default": 100 } } }, "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 } } } } } } } } } }