{ "openapi": "3.0.1", "info": { "title": "New US Trucking Carriers (FMCSA): By Date, State, Fleet Size", "description": "Newly registered US motor carriers from the official FMCSA Company Census. Filter by registration date, state and fleet size; company address, phone, DOT and MC numbers, cargo types and a company email where the register lists one. No sole proprietors. $0.004 per carrier.", "version": "0.2", "x-build-id": "kfiU7Tze4dIOUrC5e" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datagleaner~fmcsa-new-carriers/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datagleaner-fmcsa-new-carriers", "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/datagleaner~fmcsa-new-carriers/runs": { "post": { "operationId": "runs-sync-datagleaner-fmcsa-new-carriers", "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/datagleaner~fmcsa-new-carriers/run-sync": { "post": { "operationId": "run-sync-datagleaner-fmcsa-new-carriers", "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": { "feed": { "title": "Feed", "enum": [ "registrations", "authority", "coverage" ], "type": "string", "description": "`registrations`: carriers that received a new USDOT number (census add date). `authority`: carriers, brokers and freight forwarders whose FMCSA operating authority (MC/FF docket) was granted, or whose application was published in the FMCSA Register, in the date window; adds insurance on file. `coverage`: carriers, brokers and freight forwarders whose insurance filing was cancelled, or who were served an operating-authority suspension notice, in the date window (FMCSA's own status wording).", "default": "registrations" }, "daysBack": { "title": "Registered in the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only records dated in the last N days (counted back from today, UTC): the census add date, the authority action date (authority feed), or the cancellation or notice date (coverage feed). Ignored when Added from is set. Authority or coverage feed with no date: last 7 days." }, "addedFrom": { "title": "Added from (YYYY-MM-DD)", "type": "string", "description": "Optional. First date to include (census add date, or authority action date in the authority feed), for example `2026-10-01`. Overrides the days-back window." }, "addedTo": { "title": "Added to (YYYY-MM-DD)", "type": "string", "description": "Optional. Last add date to include. Default: today." }, "states": { "title": "States", "type": "array", "description": "Optional. Two-letter US state or territory codes of the company's physical (census) or business (authority feed) address, for example `TX`, `FL`. Empty: all states.", "items": { "type": "string" } }, "minPowerUnits": { "title": "Minimum power units (trucks)", "minimum": 0, "type": "integer", "description": "Optional. Only carriers that registered at least this many power units." }, "maxPowerUnits": { "title": "Maximum power units (trucks)", "minimum": 0, "type": "integer", "description": "Optional. Only carriers that registered at most this many power units." }, "forHireOnly": { "title": "Authorized for hire only", "type": "boolean", "description": "Only carriers whose classification includes Authorized For Hire (they haul other people's freight).", "default": false }, "requireEmail": { "title": "Only carriers with a company email", "type": "boolean", "description": "Skip carriers where no company email is returned. Billed rows are the ones kept.", "default": false }, "authorityEvents": { "title": "Authority events (authority feed)", "type": "array", "description": "Authority feed only. `granted`: operating authority granted on that date. `pending`: application published in the FMCSA Register on that date (not yet granted; insurance is often not filed yet). Default: granted.", "items": { "type": "string", "enum": [ "granted", "pending" ], "enumTitles": [ "Granted", "Pending (published in the FMCSA Register)" ] } }, "authorityTypes": { "title": "Authority types (authority feed)", "type": "array", "description": "Authority and coverage feeds. Empty: all types.", "items": { "type": "string", "enum": [ "motorCarrier", "broker", "freightForwarder" ], "enumTitles": [ "Motor carrier", "Broker", "Freight forwarder" ] } }, "insuranceFilter": { "title": "Liability insurance on file (authority feed)", "enum": [ "any", "missing", "onFile" ], "type": "string", "description": "Authority and coverage feeds. `missing`: the carrier file shows no liability (BIPD) filing although one is required. `onFile`: a liability filing is on file. In the coverage feed this is the carrier file today, so `missing` keeps companies with no liability filing on file now.", "default": "any" }, "coverageEvents": { "title": "Coverage events (coverage feed)", "type": "array", "description": "Coverage feed only. `insuranceCancelled`: an insurance or bond filing whose FMCSA filing status is CANCEL (replaced policies are not included), dated by the cancellation effective date. `involuntarySuspension`: FMCSA served an Operating Authority Involuntary Suspension Notice on that date. `voluntarySuspension`: a Notice Of Operating Authority Voluntary Suspension. Default: insuranceCancelled and involuntarySuspension.", "items": { "type": "string", "enum": [ "insuranceCancelled", "involuntarySuspension", "voluntarySuspension" ], "enumTitles": [ "Insurance filing cancelled", "Involuntary suspension notice", "Voluntary suspension notice" ] } }, "coverageTypes": { "title": "Cancelled coverage types (coverage feed)", "type": "array", "description": "Coverage feed only, cancellations only. Empty: all types.", "items": { "type": "string", "enum": [ "bipd", "cargo", "bond", "trustFund" ], "enumTitles": [ "Liability (BIPD)", "Cargo", "Surety bond", "Trust fund" ] } }, "onlyWithoutNewPolicy": { "title": "Only without a new policy filed (coverage feed)", "type": "boolean", "description": "Coverage feed only. Skips cancelled filings where FMCSA's active-filings file shows a newer filing of the same coverage type, so the list keeps companies with no newer filing on file. Suspension notice rows are not filtered. The check uses FMCSA's daily file; a filing may take a day or more to appear.", "default": false }, "maxItems": { "title": "Maximum carriers", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many carrier rows (each one is billed).", "default": 100 }, "requestDelayMs": { "title": "Pause between pages (ms)", "minimum": 1000, "maximum": 20000, "type": "integer", "description": "Pause between 1,000-record pages. The portal asks for at least 1 second.", "default": 1500 } } }, "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 } } } } } } } } } }