{ "openapi": "3.0.1", "info": { "title": "FMCSA New-Registration Radar: Pre-Authority Carrier Alerts", "description": "Watch your state(s), carrier operation type and fleet-size band for newly-registered FMCSA carriers: each new census registration arrives once as a deduped, contact-ready BD row (legal name, phone, email, address, fleet size). Detects new registrations (pre-authority), not authority activation.", "version": "0.0", "x-build-id": "DIxUsmlg67e9I1AhY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yungstentech~fmcsa-new-authority-radar/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yungstentech-fmcsa-new-authority-radar", "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/yungstentech~fmcsa-new-authority-radar/runs": { "post": { "operationId": "runs-sync-yungstentech-fmcsa-new-authority-radar", "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/yungstentech~fmcsa-new-authority-radar/run-sync": { "post": { "operationId": "run-sync-yungstentech-fmcsa-new-authority-radar", "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": [ "watch", "unwatch", "list-events", "report" ], "type": "string", "description": "What this run does. watch: establish (first run) or advance a standing filter-watch and deliver newly-registered carriers. unwatch: forget a saved filter's memory. list-events: replay this filter's delivered-alert history. report: one-off newly-registered cohort report for the state(s) and add_date period you name (billed once, $15).", "default": "watch" }, "states": { "title": "States", "maxItems": 10, "type": "array", "description": "Which 2-letter USPS state codes to watch, matched against the carrier's physical state (and optionally its mailing state). At least one state is required for a watch (up to 10). Report mode may leave this empty for a nationwide cohort.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "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", "DC", "PR", "VI", "GU", "AS", "MP" ] } }, "carrierOperation": { "title": "Carrier operation", "enum": [ "interstate", "intrastate", "all" ], "type": "string", "description": "Which carrier operation type to watch. interstate (census code A) is the factoring/insurance buyer's default and roughly halves the firehose; intrastate covers codes B and C; all includes every operation type.", "default": "interstate" }, "minPowerUnits": { "title": "Minimum power units", "minimum": 0, "type": "integer", "description": "Drop carriers that registered fewer than this many power units (trucks/tractors). 0 keeps every registrant; 1 filters out no-truck registrations.", "default": 0 }, "fleetSizeBand": { "title": "Fleet-size bands (optional)", "type": "array", "description": "Optional census fleetsize band codes to keep (0 and A through Z, smallest to largest). Empty keeps all bands. Use this to restrict to larger fleets.", "items": { "type": "string", "enum": [ "0", "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z" ] } }, "requireContact": { "title": "Require contact fields", "type": "boolean", "description": "Drop carriers that filed neither a phone nor an email with FMCSA. On by default: about 99.7% of new registrations carry both, so this rarely fires but guarantees every delivered row is contactable.", "default": true }, "matchMailingState": { "title": "Also match mailing state", "type": "boolean", "description": "When on, a carrier matches your states if EITHER its physical state or its mailing state is in the list. Off by default (physical state only).", "default": false }, "maxAlertsPerRun": { "title": "Max alerts per run", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on new-carrier alerts delivered and charged in a single run. Any overflow is not added to the seen-set and redelivers on the next run, and a truncation marker names how many were withheld. Bounds a catch-up run.", "default": 50 }, "maxAlertRowsPerMonth": { "title": "Max alert rows per month", "minimum": 300, "type": "integer", "description": "Per-account monthly ceiling on delivered alerts, counted across ALL of your filters this month (not per filter). Past it, the run stops charging and switches to uncharged marker rows (naming how many were withheld) instead of billing further. Guards against a slow national accrual.", "default": 1000 }, "maxMonthlySpendUsd": { "title": "Max monthly spend (USD)", "minimum": 1, "type": "integer", "description": "Product-level cap on cumulative volume-tier charges per filter-month. Once reached, the run stops charging volume-tier alerts and pushes uncharged marker rows instead. Complements the monthly alert-count ceiling; whichever trips first stops charging.", "default": 50 }, "safetyDays": { "title": "Look-back safety days", "minimum": 0, "maximum": 30, "type": "integer", "description": "How many days back the watch query always re-scans (on top of your last-seen watermark) to absorb rows FMCSA posts late. Larger is safe: the DOT-number seen-set dedupes, so a wider look-back never double-alerts, and the query stays cheap.", "default": 3 }, "webhookUrl": { "title": "Webhook URL (optional)", "type": "string", "description": "Optional https URL that receives a POST with the new alerts after each run. Best-effort alerting only: the dataset is the durable record. If you need to verify the caller, put a secret token in the URL yourself." }, "filterName": { "title": "Filter name", "type": "string", "description": "Names this filter within your account so its deduplication memory persists across scheduled runs. Lowercased and restricted to letters, digits and hyphens (1 to 40 characters). Changing a saved filter's scope under the same name re-baselines it (no back-catalog charge).", "default": "default" }, "period": { "title": "Report period (report mode)", "type": "string", "description": "Report mode only. The registration-date window for the cohort report, as YYYY-MM (a single month) or YYYY-MM..YYYY-MM (an inclusive range), for example 2026-06 or 2026-04..2026-06." }, "dryRun": { "title": "Dry run (preview, no charge)", "type": "boolean", "description": "When true, fetch, aggregate and diff but return at most 5 preview rows, charge nothing and touch no filter memory. Use it to sanity check your filter before scheduling.", "default": false } } }, "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 } } } } } } } } } }