{ "openapi": "3.0.1", "info": { "title": "FMCSA Carrier Check: Authority & Insurance Monitor", "description": "Check US motor carriers and brokers by USDOT or MC number: live SAFER authority and out-of-service status, insurance policies and cancellations, suspensions, revocations, safety rating, fleet and registered contact details. Monitor mode returns only carriers that changed since the last run.", "version": "0.1", "x-build-id": "zT5rFdllTEQf3Kbkp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/humble-echidna~fmcsa-carrier-check/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-humble-echidna-fmcsa-carrier-check", "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/humble-echidna~fmcsa-carrier-check/runs": { "post": { "operationId": "runs-sync-humble-echidna-fmcsa-carrier-check", "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/humble-echidna~fmcsa-carrier-check/run-sync": { "post": { "operationId": "run-sync-humble-echidna-fmcsa-carrier-check", "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": "Carriers to check by USDOT number, one per line, e.g. 80806 (leading zeros and a 'USDOT' prefix are fine). Combine freely with docket numbers; a carrier named twice is checked and charged once. Up to 10,000 carriers per run.", "default": [ "80806" ], "items": { "type": "string" } }, "docketNumbers": { "title": "MC / MX / FF docket numbers", "type": "array", "description": "Carriers, brokers or freight forwarders to check by docket number, one per line, e.g. MC138328, MC-138328 or FF51075. A bare number is read as an MC number. Each is matched to its USDOT number first; one that FMCSA's authority records don't have is reported in the log, not charged.", "default": [ "MC138328" ], "items": { "type": "string" } }, "liveCheck": { "title": "Live check on FMCSA's SAFER site", "type": "boolean", "description": "Read each carrier's SAFER Company Snapshot (one page a second) for its current USDOT status, operating authority status, out-of-service date, fleet, MCS-150 and safety rating, over FMCSA's daily datasets. On by default. Off: datasets only, about 20 times faster for big batches, but authority and insurance for carriers not yet in Motus are from 2026-05-14.", "default": true }, "onlyChanges": { "title": "Only changed carriers (monitor)", "type": "boolean", "description": "Return only carriers whose authority, insurance, out-of-service orders, suspensions or revocations, USDOT status or safety rating changed since this monitor's last run, each with a `changes` list (field, before, after). The first run returns every carrier as new. Unchanged carriers aren't returned and cost a small 'unchanged carrier' fee. Off (the default): every carrier is returned.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Names this monitor's memory, e.g. 'approved-carriers'. Leave empty: a saved task keeps its own memory, and runs outside a task share one called 'default'. Use different names for carrier lists you check separately. Only used with onlyChanges." }, "maxResults": { "title": "Max results per run", "minimum": 1, "type": "integer", "description": "Stop after this many carriers returned, e.g. 100. Minimum 1; leave empty (the default) for no limit. The run also stops cleanly at the maximum cost per run you set in the run options, whichever comes first. In monitor mode, carriers past the limit are compared again on the next run." }, "socrataAppToken": { "title": "Socrata app token (optional)", "type": "string", "description": "Your own free app token from data.transportation.gov (Developer settings), sent as the X-App-Token header. Optional: the data is public without it, but Socrata may throttle busy shared addresses, and with a token it doesn't. Stored encrypted, never logged." } } }, "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 } } } } } } } } } }