{ "openapi": "3.0.1", "info": { "title": "FMCSA Trucking Carrier Lookup and Monitor", "description": "Look up US trucking carriers by state, USDOT or MC number and monitor newly granted operating authority, from official FMCSA open data. No API key needed.", "version": "1.0", "x-build-id": "ju5qZHubcaV8h8ipC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jetlaunch~fmcsa-carrier-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jetlaunch-fmcsa-carrier-monitor", "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/jetlaunch~fmcsa-carrier-monitor/runs": { "post": { "operationId": "runs-sync-jetlaunch-fmcsa-carrier-monitor", "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/jetlaunch~fmcsa-carrier-monitor/run-sync": { "post": { "operationId": "run-sync-jetlaunch-fmcsa-carrier-monitor", "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": [ "search", "new-authority-monitor" ], "type": "string", "description": "Search returns carriers matching your filters. New authority monitor returns only carriers whose authority was granted since the previous run (seen carriers are remembered between runs).", "default": "search" }, "states": { "title": "States (carrier home state)", "type": "array", "description": "Two-letter state codes of the carrier's principal place of business. Leave empty for all states.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "PR", "GU", "VI", "AS", "MP" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District of Columbia", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming", "Puerto Rico", "Guam", "U.S. Virgin Islands", "American Samoa", "Northern Mariana Islands" ] } }, "dotNumbers": { "title": "USDOT numbers", "type": "array", "description": "Look up specific carriers by USDOT number. When USDOT or MC numbers are given, all other filters are ignored and each requested carrier is returned if it exists.", "items": { "type": "string" } }, "mcNumbers": { "title": "MC, MX or FF docket numbers", "type": "array", "description": "Look up carriers by docket number, for example MC-123456 or 123456. Numbers without a prefix are treated as MC numbers.", "items": { "type": "string" } }, "authorityStatus": { "title": "Operating authority status", "enum": [ "ACTIVE", "PENDING", "INACTIVE", "ANY" ], "type": "string", "description": "Keep only carriers whose operating authority has this status. ACTIVE means at least one authority of the selected kinds is active. ANY disables the filter.", "default": "ACTIVE" }, "authorityKinds": { "title": "Authority kinds", "type": "array", "description": "Which kinds of operating authority count. Default is motor carriers only. Add brokers or freight forwarders to include them.", "items": { "type": "string", "enum": [ "CARRIER", "BROKER", "FREIGHT_FORWARDER" ], "enumTitles": [ "Motor carrier", "Broker", "Freight forwarder" ] }, "default": [ "CARRIER" ] }, "usdotStatus": { "title": "USDOT registration status", "enum": [ "ACTIVE", "INACTIVE", "ANY" ], "type": "string", "description": "Status of the carrier's USDOT registration in the census file. Active is the usual choice. Use Inactive or Any when looking for carriers whose registration has lapsed.", "default": "ACTIVE" }, "operationTypes": { "title": "Operation types", "type": "array", "description": "Keep only these operation types as filed in the census. Leave empty for all.", "items": { "type": "string", "enum": [ "INTERSTATE", "INTRASTATE_HAZMAT", "INTRASTATE_NON_HAZMAT" ], "enumTitles": [ "Interstate", "Intrastate hazardous materials", "Intrastate non-hazardous materials" ] } }, "minPowerUnits": { "title": "Minimum power units", "minimum": 0, "type": "integer", "description": "Keep only carriers that report at least this many power units (trucks and tractors).", "default": 0 }, "newAuthoritySince": { "title": "New authority since (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Search mode: return only carriers that were granted operating authority on or after this date, newest first. Leave empty for no date filter. In monitor mode this only sets the start date of the very first run." }, "sortBy": { "title": "Sort order (search mode)", "enum": [ "DOT_NUMBER", "POWER_UNITS_DESC", "NEWEST_USDOT_REGISTRATION" ], "type": "string", "description": "Order of results when no new authority date is set.", "default": "DOT_NUMBER" }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop after this many carriers. You are charged per carrier returned.", "default": 25 }, "includeSafetyCounts": { "title": "Include inspection and crash counts", "type": "boolean", "description": "Add inspection, out-of-service inspection, crash, fatality and injury counts for the last 24 months from the FMCSA inspection and crash files.", "default": true }, "excludeLikelyIndividuals": { "title": "Skip likely sole proprietors", "type": "boolean", "description": "Leave out carriers whose legal name looks like a personal name or whose census record says Individual. This is a heuristic. If off, such carriers are still returned but with legalName and dbaName set to null.", "default": false }, "monitorName": { "title": "Monitor name", "pattern": "^[a-z0-9]([a-z0-9-]{0,40}[a-z0-9])?$", "type": "string", "description": "Monitor mode only. Seen carriers are stored under this name in your account, so each name keeps its own memory. Use a different name for each set of filters. Lowercase letters, digits and hyphens.", "default": "default" }, "lookbackDays": { "title": "First run lookback (days)", "minimum": 0, "maximum": 365, "type": "integer", "description": "Monitor mode only. On the first run, return carriers granted authority in the last N days. Later runs continue from the previous run.", "default": 7 }, "resetMonitorState": { "title": "Reset monitor memory", "type": "boolean", "description": "Monitor mode only. Ignore the saved list of seen carriers and start again.", "default": false }, "socrataAppToken": { "title": "Socrata app token (optional)", "type": "string", "description": "Optional free app token from the data.transportation.gov portal. It gives your runs their own rate-limit pool. Not needed for normal use." } } }, "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 } } } } } } } } } }