{ "openapi": "3.0.1", "info": { "title": "FMCSA Carrier Authority, Insurance & Safety Monitor", "description": "Look up and bulk-export official FMCSA carrier profiles, identify fresh registrations, and track explicit MOTUS authority, insurance, suspension and public safety changes.", "version": "0.1", "x-build-id": "HYWfZadM2jeqv8MTL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/luminar~fmcsa-carrier-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-luminar-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/luminar~fmcsa-carrier-monitor/runs": { "post": { "operationId": "runs-sync-luminar-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/luminar~fmcsa-carrier-monitor/run-sync": { "post": { "operationId": "run-sync-luminar-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": { "workflow": { "title": "Workflow", "enum": [ "CURRENT_PROFILE", "BULK_EXPORT", "NEW_REGISTRATIONS", "CHANGES" ], "type": "string", "description": "Current Profile resolves named carriers. Bulk Export streams the same normalized official profile up to 500,000 rows. New Registrations separates a new USDOT registration from an authority grant. Changes reconciles requested official daily-difference rows against their full baseline.", "default": "CURRENT_PROFILE" }, "usdotNumbers": { "title": "USDOT numbers", "maxItems": 5000, "uniqueItems": true, "type": "array", "description": "Exact carrier identifiers for Current Profile or a Changes watchlist. Punctuation and leading zeroes are normalized without changing the raw source value. Combined USDOT, docket and company targets cannot exceed 5,000.", "items": { "type": "string", "pattern": "^[0-9 .-]{1,14}$", "maxLength": 14 } }, "docketNumbers": { "title": "MC, MX, or FF docket numbers", "maxItems": 5000, "uniqueItems": true, "type": "array", "description": "Official operating-authority docket identifiers. Use the MC, MX, or FF prefix. They are resolved to USDOT when the source publishes that link.", "items": { "type": "string", "pattern": "^(?:[Mm][Cc]|[Mm][Xx]|[Ff][Ff])[ ._-]*[0-9]{1,10}$", "maxLength": 14 } }, "companyNames": { "title": "Company names", "maxItems": 1000, "uniqueItems": true, "type": "array", "description": "Legal/DBA contains-match for Current Profile, Bulk Export, or a Changes watchlist. It narrows the requested scope, reports FILTERED coverage, and cannot prove that no other entity exists.", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "maxResults": { "title": "Maximum result rows", "minimum": 1, "maximum": 500000, "type": "integer", "description": "Current Profile accepts up to 5,000; Bulk Export up to 500,000; New Registrations up to 10,000. The runtime enforces the selected workflow boundary and reports CAPPED when more official rows may exist.", "default": 1 }, "maxBuyerChargeUsd": { "title": "Maximum Actor charge", "minimum": 0.001, "maximum": 10000, "type": "number", "description": "Fail before source work when the worst-case configured event total for the chosen limits exceeds this guard. Increase it deliberately for bulk modes.", "default": 0.25 }, "changeScope": { "title": "Changes scope", "enum": [ "WATCHLIST", "NATIONWIDE" ], "type": "string", "description": "Used only by Track verified changes. Watchlist requires at least one target. Nationwide reads the bounded current official daily cycle.", "default": "WATCHLIST" }, "eventTypes": { "title": "Change types", "uniqueItems": true, "type": "array", "description": "Only these explicitly mapped official-source events can be delivered. There is no ALL_CHANGES or generic REVOKED event. Nationwide mode supports daily-difference and append-only safety events; full-snapshot safety rating, OOS-order, and SMS comparisons are watchlist-only.", "items": { "type": "string", "enum": [ "NEW_REGISTRATION", "AUTHORITY_PENDING", "AUTHORITY_GRANTED", "AUTHORITY_REINSTATED", "AUTHORITY_WITHDRAWN", "AUTHORITY_VOLUNTARILY_SUSPENDED", "AUTHORITY_INVOLUNTARILY_SUSPENDED", "AUTHORITY_VOLUNTARY_SUSPENSION_NOTICE", "AUTHORITY_INVOLUNTARY_SUSPENSION_NOTICE", "INSURANCE_CANCELLATION_FILED", "INSURANCE_TERMINATED_OR_REPLACED", "INSURANCE_NAME_CHANGED", "INSURANCE_POLICY_ADDED_OR_UPDATED", "INSURANCE_POLICY_DROPPED", "INSPECTION_RECORDED", "INSPECTION_OOS_RECORDED", "VIOLATION_RECORDED", "CRASH_RECORDED", "NEW_ENTRANT_OOS_ORDER_ISSUED", "NEW_ENTRANT_OOS_ORDER_RESCINDED", "SAFETY_RATING_CHANGED", "SMS_MEASURE_CHANGED", "SMS_PUBLIC_ALERT_CHANGED", "SMS_PASSENGER_PERCENTILE_CHANGED" ], "enumTitles": [ "New registration", "Authority pending", "Authority granted", "Authority reinstated", "Authority withdrawn", "Authority voluntarily suspended", "Authority involuntarily suspended", "Voluntary suspension notice", "Involuntary suspension notice", "Insurance cancellation filed", "Insurance terminated or replaced", "Insured name changed", "Insurance policy added or updated", "Insurance policy dropped", "Roadside inspection recorded", "Inspection out-of-service recorded", "Violation recorded", "Crash involvement recorded", "New Entrant OOS order issued", "New Entrant OOS order rescinded", "Safety rating changed", "Public SMS measure changed", "Public SMS alert changed", "Passenger-carrier SMS percentile changed" ] }, "default": [ "NEW_REGISTRATION", "AUTHORITY_GRANTED", "AUTHORITY_REINSTATED", "AUTHORITY_WITHDRAWN", "AUTHORITY_VOLUNTARILY_SUSPENDED", "AUTHORITY_INVOLUNTARILY_SUSPENDED", "AUTHORITY_VOLUNTARY_SUSPENSION_NOTICE", "AUTHORITY_INVOLUNTARY_SUSPENSION_NOTICE", "INSURANCE_CANCELLATION_FILED", "INSURANCE_TERMINATED_OR_REPLACED", "INSURANCE_NAME_CHANGED", "INSURANCE_POLICY_ADDED_OR_UPDATED", "INSURANCE_POLICY_DROPPED" ] }, "maxEvents": { "title": "Maximum delivered changes", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard Changes delivery and charging cap. Reaching it reports CAPPED; incomplete work never proves deletion.", "default": 10 }, "maxStateTargets": { "title": "Maximum monitored targets", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Versioned state capacity for Changes. It must cover every requested watchlist target and is independently tested at 5,000.", "default": 1000 }, "daysBack": { "title": "Registration lookback", "minimum": 1, "maximum": 365, "type": "integer", "description": "Used by New Registrations. A census add date proves a new registration, not an operating-authority grant.", "default": 30 }, "states": { "title": "Physical-address states", "maxItems": 52, "uniqueItems": true, "type": "array", "description": "Optional two-letter state filters for bulk, new registrations, current profiles, or change enrichment. Filtered emptiness is not source-wide absence.", "items": { "type": "string", "pattern": "^[A-Za-z]{2}$", "maxLength": 2 } }, "carrierOperations": { "title": "Carrier operations", "maxItems": 16, "uniqueItems": true, "type": "array", "description": "Optional exact Company Census carrier-operation values or codes. Unknown text returns a filtered empty result instead of being guessed.", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "authorityTypes": { "title": "Operating-authority types", "maxItems": 32, "uniqueItems": true, "type": "array", "description": "Optional exact modern MOTUS authority-type filters. Unknown future values fail as source-contract drift instead of being silently remapped.", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "activeOnly": { "title": "Active census entities only", "type": "boolean", "description": "Applies the official Company Census active status filter. It does not replace authority status.", "default": false }, "hazmatOnly": { "title": "Hazmat carriers only", "type": "boolean", "description": "Keeps Company Census rows carrying the official hazmat indicator.", "default": false }, "minPowerUnits": { "title": "Minimum power units", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Optional fleet-size floor.", "default": 0 }, "maxPowerUnits": { "title": "Maximum power units", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Optional fleet-size ceiling. It must be at least Minimum power units.", "default": 1000000 }, "registeredAfter": { "title": "Registered on or after", "pattern": "^$|^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "type": "string", "description": "Optional YYYY-MM-DD Company Census add-date filter." }, "registeredBefore": { "title": "Registered on or before", "pattern": "^$|^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "type": "string", "description": "Optional YYYY-MM-DD Company Census add-date filter." }, "includeAuthority": { "title": "Include operating authority", "type": "boolean", "description": "Joins official modern MOTUS docket/type/status, requirements and filed indicators.", "default": true }, "includeInsurance": { "title": "Include current insurance policies", "type": "boolean", "description": "Joins official current/pending Motus Insur rows. Cancellation filings are separately labeled and never treated as proof of no replacement coverage.", "default": true }, "includeSafetySummary": { "title": "Include public safety summary", "type": "boolean", "description": "Adds official safety rating, public SMS measures, OOS orders, and lookback-bounded inspection/crash aggregates to Current Profile and Bulk Export. This increases source transfer, disk work, and runtime.", "default": true }, "includeSafetyEvents": { "title": "Include roadside inspection, violation, and crash events", "type": "boolean", "description": "Allows selected stable-ID safety events in Changes. Also select their Change types. Crash involvement is not fault; roadside inspection OOS is not a carrier operation OOS order.", "default": false }, "includeSmsMeasures": { "title": "Include monthly public SMS measures", "type": "boolean", "description": "Adds public monthly measures. Passenger percentiles/alerts are included only where the official cohort dataset publishes them; property percentiles are not promised.", "default": true }, "includePendingAuthorities": { "title": "Include pending authorities", "type": "boolean", "description": "Allows AUTHORITY_PENDING events. Pending status is not permission to operate.", "default": false }, "safetyLookbackMonths": { "title": "Safety-summary lookback", "minimum": 1, "maximum": 60, "type": "integer", "description": "Limits inspection and crash rows joined into Current Profile and Bulk Export summaries. A longer window increases official-source transfer, temporary disk use, and run time.", "default": 24 }, "outputProfile": { "title": "Result detail", "enum": [ "ESSENTIAL", "STANDARD", "FULL" ], "type": "string", "description": "Controls current/bulk profile detail without changing monitoring identity. Every public field remains declared in the Dataset schema.", "default": "STANDARD" }, "maxSourceRequests": { "title": "Maximum source requests", "minimum": 1, "maximum": 30000, "type": "integer", "description": "Fail-closed request guard for metadata and deterministic paginated source exhaustion. It never turns a stopped traversal into COMPLETE.", "default": 30000 }, "maxSourceBytes": { "title": "Maximum source bytes", "minimum": 100000, "maximum": 10000000000, "type": "integer", "description": "Infrastructure transfer guard for streaming official files.", "default": 8000000000 }, "maxRuntimeSecs": { "title": "Maximum source runtime", "minimum": 30, "maximum": 3300, "type": "integer", "description": "Infrastructure source-work deadline below the Actor timeout.", "default": 3300 }, "maxTemporaryDiskBytes": { "title": "Maximum temporary disk bytes", "minimum": 10000000, "maximum": 10000000000, "type": "integer", "description": "Disk guard for hash-partitioned full-file joins.", "default": 8000000000 }, "maxEstimatedPlatformUsd": { "title": "Maximum estimated platform spend", "minimum": 0.01, "maximum": 25, "type": "number", "description": "Fail-closed infrastructure estimate; final settled usageTotalUsd remains authoritative.", "default": 3 }, "maxSourceRowsPerDataset": { "title": "Maximum rows per official dataset", "minimum": 1, "maximum": 20000000, "type": "integer", "description": "Hard traversal guard. Reaching it with an N+1 row reports CAPPED and prevents a completeness claim.", "default": 15000000 }, "maxSocrataPagesPerDataset": { "title": "Maximum pages per official dataset", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard deterministic pagination guard. Every page uses stable order, offset, and N+1 exhaustion receipts.", "default": 2000 }, "_luminarQaFaultStage": { "title": "Luminar private QA fault stage", "type": "string", "description": "Factory-controlled private QA fault probe. Omit for every normal run. Runtime identity, fleet exclusion, actor key and immutable canonical build-tag guards must all pass before this value can take effect." } } }, "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 } } }, "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 } } } } } } } } } }