{
  "openapi": "3.0.1",
  "info": {
    "title": "FMCSA New Motor Carrier Leads: New Authority, Email & Phone",
    "description": "New motor carrier leads from the official FMCSA census: new USDOT/MC trucking companies with officer names, authority status, filed email and phone. Filter by state and fleet size; deduped, so daily runs only bill new carriers. 141 automated checks.",
    "version": "0.1",
    "x-build-id": "ZeuPSyy18WQ8QDcIF"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/transparent_meteorite~fmcsa-new-carrier-leads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-transparent_meteorite-fmcsa-new-carrier-leads",
        "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/transparent_meteorite~fmcsa-new-carrier-leads/runs": {
      "post": {
        "operationId": "runs-sync-transparent_meteorite-fmcsa-new-carrier-leads",
        "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/transparent_meteorite~fmcsa-new-carrier-leads/run-sync": {
      "post": {
        "operationId": "run-sync-transparent_meteorite-fmcsa-new-carrier-leads",
        "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": [
              "newCarriers",
              "lookup"
            ],
            "type": "string",
            "description": "newCarriers (default) = the feed of carriers newly added to the FMCSA census in the last N days. lookup = look up specific carriers by USDOT number, MC/MX number or company name, any registration date; the date window, 'Only new since last run' and 'Only carriers with an email' are ignored.",
            "default": "newCarriers"
          },
          "states": {
            "title": "States (2-letter)",
            "type": "array",
            "description": "Two-letter state codes to include, e.g. [\"TX\",\"FL\",\"GA\"]. Leave empty to get new carriers from every US state.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "daysBack": {
            "title": "New in the last N days",
            "minimum": 1,
            "maximum": 120,
            "type": "integer",
            "description": "Only carriers added to the FMCSA census in the last N days. 7 = this week's new authorities. Use 1-3 for a daily scheduled feed.",
            "default": 7
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Hard cap on carriers returned, and charged, in this run. Each carrier is $0.0035 through October 21, 2026, then $0.008 (1,000 = $8).",
            "default": 100
          },
          "requireEmail": {
            "title": "Only carriers with an email",
            "type": "boolean",
            "description": "Return only carriers with an email address on their FMCSA filing. In our June 2026 sample of the 200 newest carriers, all 200 had one.",
            "default": true
          },
          "onlyNewSinceLastRun": {
            "title": "Only new since last run (deduped)",
            "type": "boolean",
            "description": "Skip any carrier (by USDOT number) you already received in an earlier run, so you are never charged twice for the same carrier. Turn off to re-pull the same window.",
            "default": true
          },
          "requirePhone": {
            "title": "Only carriers with a phone",
            "type": "boolean",
            "description": "Return only carriers with a phone or cell number on file.",
            "default": false
          },
          "carrierOperation": {
            "title": "Carrier operation type",
            "enum": [
              "any",
              "interstate",
              "intrastate"
            ],
            "type": "string",
            "description": "Interstate = hauls across state lines. Intrastate = operates inside one state only.",
            "default": "any"
          },
          "minPowerUnits": {
            "title": "Minimum power units (fleet size)",
            "minimum": 0,
            "type": "integer",
            "description": "Only carriers with at least this many trucks (power units). 0 = no minimum. Most new authorities run 1-5 trucks.",
            "default": 0
          },
          "maxPowerUnits": {
            "title": "Maximum power units (fleet size)",
            "minimum": 0,
            "type": "integer",
            "description": "Only carriers with at most this many trucks. 0 = no maximum.",
            "default": 0
          },
          "minDrivers": {
            "title": "Minimum drivers",
            "minimum": 0,
            "type": "integer",
            "description": "Only carriers reporting at least this many drivers. 0 = no minimum.",
            "default": 0
          },
          "maxDrivers": {
            "title": "Maximum drivers",
            "minimum": 0,
            "type": "integer",
            "description": "Only carriers reporting at most this many drivers. 0 = no maximum.",
            "default": 0
          },
          "hazmatOnly": {
            "title": "Hazmat carriers only",
            "type": "boolean",
            "description": "Return only carriers flagged as hazardous-materials carriers in the FMCSA census.",
            "default": false
          },
          "forHireOnly": {
            "title": "For-hire trucking companies only",
            "type": "boolean",
            "description": "USDOT numbers are also issued to businesses that only move their own goods (contractors, landscapers, home improvement firms). Turn this on to keep only carriers registered as authorized or exempt for-hire, i.e. companies that haul freight for others. About 3 in 4 new registrations pass (Sept 2026 data).",
            "default": false
          },
          "authorityStatus": {
            "title": "Operating authority status",
            "enum": [
              "any",
              "Active",
              "Pending",
              "Inactive",
              "Withdrawn"
            ],
            "type": "string",
            "description": "Keep only carriers whose operating authority (MC/MX docket) has this status in the FMCSA authority history. Brand-new carriers are usually Pending until their authority is granted. 'Any' (default) applies no filter.",
            "default": "any"
          },
          "includeAuthority": {
            "title": "Include operating authority fields",
            "type": "boolean",
            "description": "Adds authority_type, authority_status, authority_granted_date and per-docket history from the FMCSA authority dataset (one extra free public API call per 100 carriers). Turn off to skip it.",
            "default": true
          },
          "cargoTypes": {
            "title": "Cargo types (any of)",
            "type": "array",
            "description": "Only carriers that declare at least one of these cargo types on their filing. Keys: genfreight, household, metalsheet, motoveh, drivetow, logpole, bldgmat, mobilehome, machlrg, produce, liqgas, intermodal, passengers, oilfield, livestock, grainfeed, coalcoke, meat, garbage, usmail, chem, drybulk, coldfood, beverages, paperprod, utility, farmsupp, construct, waterwell, cargoothr.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "nameContains": {
            "title": "Company name contains",
            "type": "string",
            "description": "Only carriers whose legal or DBA name contains this text (case-insensitive), e.g. LOGISTICS.",
            "default": ""
          },
          "companyName": {
            "title": "Company name (lookup mode)",
            "type": "string",
            "description": "Lookup mode: find carriers whose legal or DBA name contains this text (case-insensitive), e.g. WERNER. Same matching as 'Company name contains'; use either one.",
            "default": ""
          },
          "dotNumbers": {
            "title": "USDOT numbers (lookup mode)",
            "type": "array",
            "description": "Look up these exact carriers by USDOT number, any registration date. When set, the 'new in the last N days' window is ignored. Turn off 'Only new since last run' and 'Only carriers with an email' to get every listed carrier.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "mcNumbers": {
            "title": "MC numbers (lookup mode)",
            "type": "array",
            "description": "Look up carriers by MC (operating authority) number, digits only. Same behavior as USDOT lookup; can be combined with it.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "socrataAppToken": {
            "title": "Socrata app token (optional)",
            "type": "string",
            "description": "Free app token from data.transportation.gov. Only useful for very large or very frequent pulls, to avoid shared rate limits. Can also be set with the SOCRATA_APP_TOKEN environment variable."
          },
          "webhookUrl": {
            "title": "Webhook URL (optional)",
            "type": "string",
            "description": "Optional. Delivered carriers are POSTed here as JSON batches: { source, count, records: [...] }. Use it to push leads straight into a CRM, or an n8n, Make or Zapier webhook.",
            "default": ""
          },
          "webhookBatchSize": {
            "title": "Webhook batch size",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "How many records per webhook POST.",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}