{ "openapi": "3.0.1", "info": { "title": "FMCSA Carrier Lookup: USDOT, MC, Insurance & New Authority", "description": "FMCSA carrier lookup by USDOT or MC number, or a list of new trucking and broker authorities by state and date. One row per company: name, status, fleet size, safety rating, operating authority, and carrier insurance and broker bonds on file. No API key. Not affiliated with FMCSA or USDOT.", "version": "0.2", "x-build-id": "CyR5VqczFgxVlM3fD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yourevenings~fmcsa-carrier-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yourevenings-fmcsa-carrier-lookup", "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/yourevenings~fmcsa-carrier-lookup/runs": { "post": { "operationId": "runs-sync-yourevenings-fmcsa-carrier-lookup", "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/yourevenings~fmcsa-carrier-lookup/run-sync": { "post": { "operationId": "run-sync-yourevenings-fmcsa-carrier-lookup", "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": { "mode": { "title": "Mode", "enum": [ "lookup", "search", "newAuthority", "newUsdotRegistrations" ], "type": "string", "description": "Leave empty to choose automatically: numbers given → lookup, a name → search, otherwise new operating authorities. Lookup: one row per USDOT or MC number you give. Search: companies whose legal or DBA name contains your words. New operating authorities: carriers, brokers and freight forwarders granted authority by FMCSA between two dates. New USDOT registrations: companies whose USDOT number was added to the FMCSA census between two dates. Most have no operating authority granted yet." }, "usdotNumbers": { "title": "USDOT numbers (lookup)", "type": "array", "description": "Up to 1,000 USDOT numbers in total with MC numbers. \"80806\", \"USDOT 80806\" and \"DOT#80806\" all work.", "items": { "type": "string" } }, "mcNumbers": { "title": "MC numbers (lookup)", "type": "array", "description": "MC, MX or FF docket numbers. \"MC-135797\", \"MC135797\" and \"135797\" all work (plain numbers are read as MC).", "items": { "type": "string" } }, "name": { "title": "Company name (search)", "type": "string", "description": "At least 3 letters or digits. Matches the legal name or DBA name, any position, not case-sensitive." }, "newAuthorityDays": { "title": "In the last N days (new lists)", "minimum": 1, "maximum": 366, "type": "integer", "description": "Used when no dates are set. 7 means the last 7 days including today. New operating authorities count from the grant date; new USDOT registrations count from the date the USDOT number was added to the census. FMCSA publishes authority grants daily; in the census the last day or two can be incomplete.", "default": 7 }, "newAuthoritySince": { "title": "From date (new lists)", "type": "string", "description": "First grant date (new operating authorities) or first USDOT added date (new USDOT registrations) to include, e.g. 2026-10-25. Overrides the number of days." }, "newAuthorityUntil": { "title": "To date (new lists)", "type": "string", "description": "Last date to include. Defaults to today." }, "authorityTypes": { "title": "Authority types (new authority)", "type": "array", "description": "New operating authorities only: keep grants of these types. Leave empty for all. Not used for new USDOT registrations.", "items": { "type": "string", "enum": [ "carrier_property", "carrier_hhg", "carrier_passenger", "broker_property", "broker_hhg", "freight_forwarder" ], "enumTitles": [ "Motor carrier of property", "Motor carrier of household goods", "Motor carrier of passengers", "Broker of property", "Broker of household goods", "Freight forwarder" ] } }, "states": { "title": "States or provinces", "type": "array", "description": "Two-letter codes of the physical location, e.g. TX, CA, ON. Leave empty for all.", "items": { "type": "string" } }, "insuranceStatus": { "title": "Insurance as filed with FMCSA", "enum": [ "any", "active", "on_file", "missing_required", "cancellation_pending", "no_active_authority" ], "type": "string", "description": "Keep only companies with this insurance status, as filed with FMCSA. Works in every mode. Active means at least one BIPD (liability) filing, insurance (BMC-91 or BMC-91X) or a BMC-82 liability surety bond, that is not cancelled and whose effective date is on or before today. Carriers FMCSA has approved to self-insure are listed with a BMC-91X filing and the insurer Self-Insured, and they match. Cancellation notices (BMC-35, BMC-36) never count as cover. The other values compare filings with what each active authority requires.", "default": "any" }, "includeInactive": { "title": "Include inactive USDOT numbers", "type": "boolean", "description": "Search and the new lists return active USDOT numbers only unless this is on. Lookup always returns the number you asked for." }, "operation": { "title": "Operation", "enum": [ "any", "interstate", "intrastate" ], "type": "string", "description": "Interstate or intrastate operation, from the census file.", "default": "any" }, "forHireOnly": { "title": "For-hire only", "type": "boolean", "description": "Only companies classed as authorized for hire.", "default": false }, "withMcNumberOnly": { "title": "With an MC number only", "type": "boolean", "description": "Only companies with at least one MC number. In the new lists this includes MC numbers still pending in FMCSA's authority files (applied for, not yet granted), when authority and insurance are included (the default).", "default": false }, "hazmatOnly": { "title": "Hazmat only", "type": "boolean", "description": "Only hazardous materials carriers.", "default": false }, "cargoTypes": { "title": "Cargo carried", "type": "array", "description": "Keep companies that reported at least one of these cargo types on their MCS-150 (the census cargo boxes). Leave empty for all. Works in search and the new lists, not in lookup. Self-reported by the company on its MCS-150.", "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", "farm_supplies", "construction", "water_well", "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", "minimum": 0, "type": "integer", "description": "Trucks, tractors and buses, as reported on the MCS-150." }, "maxPowerUnits": { "title": "Maximum power units", "minimum": 0, "type": "integer", "description": "Trucks, tractors and buses, as reported on the MCS-150." }, "maxResults": { "title": "Maximum companies", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Stop after this many company rows (each is one carrier-record event). 0 means the 10,000 cap. Status rows are free.", "default": 1000 }, "includeAuthorityAndInsurance": { "title": "Add authority and insurance", "type": "boolean", "description": "Operating authority, insurance and bonds on file, and suspension notices. Turn off for census fields only (faster). Always on when an insurance status filter is set.", "default": true }, "monitorMode": { "title": "Monitor mode", "type": "boolean", "description": "Lookup: return only companies whose status, authority, insurance, rating or suspensions changed since the last run. Search and the new lists: return only companies not returned before. One monitor-run event per run with results; runs with nothing new cost nothing extra.", "default": false }, "emitBaselineOnFirstRun": { "title": "Return companies on the first monitor run", "type": "boolean", "description": "Off: the first run only saves a baseline, returns nothing and charges nothing.", "default": true }, "stateStoreName": { "title": "Monitor name", "type": "string", "description": "Named key-value store that remembers what was returned. Use a different name for each saved search or list.", "default": "fmcsa-carriers-monitor" } } }, "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 } } } } } } } } } }