{ "openapi": "3.0.1", "info": { "title": "FMCSA API | DOT & MC Number Lookup, New Authority Leads", "description": "Extract FMCSA carrier data at $1.00 per 1,000 records: DOT number lookup, MC number lookup and company-name search, plus daily feeds of new USDOT registrations and new operating authority. Phone, email, address, fleet, drivers, cargo, insurance on file, out of service.", "version": "0.1", "x-build-id": "sZamNTiR69pLVysiH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aurelix~fmcsa-carrier-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aurelix-fmcsa-carrier-api", "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/aurelix~fmcsa-carrier-api/runs": { "post": { "operationId": "runs-sync-aurelix-fmcsa-carrier-api", "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/aurelix~fmcsa-carrier-api/run-sync": { "post": { "operationId": "run-sync-aurelix-fmcsa-carrier-api", "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", "type": "array", "description": "Look up carriers by USDOT number, one per line, e.g. 53467 or 'USDOT 53467' or a SAFER link. Filters below do not apply to number lookups.", "default": [], "items": { "type": "string" } }, "mcNumbers": { "title": "MC / MX / FF numbers", "type": "array", "description": "Look up by docket (operating authority) number, e.g. MC-138328, MC138328 or 138328 (read as MC). Filters below do not apply to number lookups.", "default": [], "items": { "type": "string" } }, "companyNames": { "title": "Company names", "type": "array", "description": "Carriers whose legal or DBA name contains all these words, one name per line, e.g. 'Swift Transportation'. The filters below apply.", "default": [], "items": { "type": "string" } }, "feed": { "title": "New carriers feed", "enum": [ "none", "new_registrations", "authority_events" ], "type": "string", "description": "Optional list of new entries in a date window (filters apply). New USDOT registrations: carriers, brokers and shippers that got a USDOT number. Authority events: operating authority granted, applied for, suspended, reinstated and more (choose below). Empty input with no numbers or names = new registrations of the last 7 days.", "default": "none" }, "authorityEvents": { "title": "Authority events", "type": "array", "description": "For the authority-events feed: which status changes. Default: granted.", "items": { "type": "string", "enum": [ "granted", "applied", "published", "suspended", "inactivated", "reinstated", "withdrawn" ], "enumTitles": [ "Authority granted", "Applied (new application)", "Published to the FMCSA Register", "Suspended (insurance, BOC-3 or voluntary)", "Inactivated / out of service", "Reinstated", "Withdrawn" ] }, "default": [ "granted" ] }, "authorityTypes": { "title": "Authority types", "type": "array", "description": "For the authority-events feed: keep only these authority types. Empty = all.", "items": { "type": "string", "enum": [ "property", "passengers", "household_goods", "broker", "freight_forwarder" ], "enumTitles": [ "Motor carrier of property", "Motor carrier of passengers", "Motor carrier of household goods", "Broker", "Freight forwarder" ] }, "default": [] }, "daysBack": { "title": "Feed window: last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "For the feeds: registrations or authority events of today (UTC) and the N days before. FMCSA publishes daily; use 1 to 2 for a daily watch.", "default": 7 }, "dateFrom": { "title": "Feed window: from date", "type": "string", "description": "Optional fixed start date (YYYY-MM-DD); overrides 'last N days'." }, "dateTo": { "title": "Feed window: to date", "type": "string", "description": "Optional fixed end date (YYYY-MM-DD). Empty = today." }, "states": { "title": "States", "type": "array", "description": "Physical-address state or province codes, e.g. TX, CA, ON. Empty = all.", "default": [], "items": { "type": "string" } }, "entityTypes": { "title": "Entity types", "type": "array", "description": "Keep entities with at least one of these types. Empty = all.", "items": { "type": "string", "enum": [ "carrier", "broker", "shipper", "freight_forwarder", "registrant", "intermodal_equipment_provider", "cargo_tank" ], "enumTitles": [ "Carrier", "Broker", "Shipper", "Freight forwarder", "Registrant", "Intermodal equipment provider", "Cargo tank" ] }, "default": [] }, "operations": { "title": "Carrier operation", "type": "array", "description": "Interstate, intrastate hazmat or intrastate non-hazmat. Empty = all.", "items": { "type": "string", "enum": [ "interstate", "intrastate_hazmat", "intrastate_non_hazmat" ], "enumTitles": [ "Interstate", "Intrastate hazmat", "Intrastate non-hazmat" ] }, "default": [] }, "cargoTypes": { "title": "Cargo carried", "type": "array", "description": "Keep carriers that list at least one of these cargo types. Empty = all.", "items": { "type": "string", "enum": [ "genfreight", "household", "metalsheet", "motoveh", "drivetow", "logpole", "bldgmat", "mobilehome", "machlrg", "produce", "liqgas", "intermodal", "passengers", "oilfield", "livestock", "grainfeed", "coalcoke", "meat", "garbage", "usmail", "chem", "drybulk", "coldfood", "beverages", "paperprod", "utility", "farmsupp", "construct", "waterwell", "cargoothr" ], "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", "US Mail", "Chemicals", "Commodities Dry Bulk", "Refrigerated Food", "Beverages", "Paper Products", "Utilities", "Agricultural/Farm Supplies", "Construction", "Water Well", "Other" ] }, "default": [] }, "minPowerUnits": { "title": "Min power units", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Trucks, tractors and buses at least this many. 0 = no minimum.", "default": 0 }, "maxPowerUnits": { "title": "Max power units", "minimum": 0, "maximum": 100000, "type": "integer", "description": "At most this many power units, e.g. 5 for small fleets. Empty = no maximum." }, "minDrivers": { "title": "Min drivers", "minimum": 0, "maximum": 100000, "type": "integer", "description": "At least this many drivers. 0 = no minimum.", "default": 0 }, "hazmatOnly": { "title": "Hazmat carriers only", "type": "boolean", "description": "Keep only carriers flagged as hazardous-materials carriers.", "default": false }, "activeOnly": { "title": "Active USDOT status only", "type": "boolean", "description": "Drop inactive USDOT records.", "default": false }, "requireEmail": { "title": "Must have an email", "type": "boolean", "description": "Keep only records with an email on file.", "default": false }, "requirePhone": { "title": "Must have a phone", "type": "boolean", "description": "Keep only records with a phone on file.", "default": false }, "maxResultsPerSearch": { "title": "Max carriers per company name", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop each company-name search after this many carriers.", "default": 50 }, "maxResults": { "title": "Max carriers in total", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop the run after this many records, at most 10,000 per run (split bigger jobs by date window or state).", "default": 200 }, "incremental": { "title": "Only new since last run (watch)", "type": "boolean", "description": "Return only carriers (or authority events) that earlier runs with the same input, or the same 'Watch name', did not return. If your caps cut the first run short, the rest of its window is remembered (not returned or charged), so later runs return only genuinely new entries. Schedule daily for a new-authority lead feed.", "default": false }, "stateKey": { "title": "Watch name", "type": "string", "description": "Optional name for the watch memory, e.g. 'tx-new-authority'." }, "socrataAppToken": { "title": "Socrata app token (optional)", "type": "string", "description": "Optional free app token from data.transportation.gov for higher rate limits on very large runs. Not needed normally." }, "slackWebhookUrl": { "title": "Slack webhook URL", "type": "string", "description": "Optional: post a digest (count and top 10) to Slack after a run that saved records." }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional: POST the digest as JSON to this URL (n8n, Make, Zapier)." } } }, "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 } } } } } } } } } }