{
  "openapi": "3.0.1",
  "info": {
    "title": "New Trucking Companies: FMCSA New Authority & MC Number Leads",
    "description": "New trucking company leads from official FMCSA data: newly granted MC authorities (carriers, brokers, freight forwarders) with USDOT, phone, email, address and fleet size. Optional new-USDOT census mode. No API key.",
    "version": "0.1",
    "x-build-id": "ZVftGzdmsdWCrMEce"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/quarrylane-data~fmcsa-new-authority-leads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-quarrylane-data-fmcsa-new-authority-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/quarrylane-data~fmcsa-new-authority-leads/runs": {
      "post": {
        "operationId": "runs-sync-quarrylane-data-fmcsa-new-authority-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/quarrylane-data~fmcsa-new-authority-leads/run-sync": {
      "post": {
        "operationId": "run-sync-quarrylane-data-fmcsa-new-authority-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": [
              "new-authorities",
              "census"
            ],
            "type": "string",
            "description": "Default is newly granted operating authorities. Census mode lists USDOT numbers added to the official census in the same date window, billed as carrier-record events.",
            "default": "new-authorities"
          },
          "daysBack": {
            "title": "Date window (days back)",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Used when startDate is empty. Default last 14 days of grant dates (or census add dates in census mode).",
            "default": 14
          },
          "startDate": {
            "title": "Start date",
            "type": "string",
            "description": "YYYY-MM-DD inclusive. Grant date (status_change_date) in authority mode, or census add_date in census mode."
          },
          "endDate": {
            "title": "End date",
            "type": "string",
            "description": "Last grant date to include, as YYYY-MM-DD (inclusive). Defaults to today."
          },
          "authorityTypes": {
            "title": "Authority type",
            "type": "array",
            "description": "Optional. Default is all granted types (motor carrier, broker, freight forwarder, including household-goods and passenger variants).",
            "items": {
              "type": "string",
              "enum": [
                "carrier",
                "broker",
                "freight-forwarder"
              ],
              "enumTitles": [
                "Motor carrier",
                "Broker",
                "Freight forwarder"
              ]
            }
          },
          "states": {
            "title": "Physical state",
            "type": "array",
            "description": "Two-letter states from the census physical address (e.g. TX, CA). Applied after joining AuthHist to the census.",
            "items": {
              "type": "string"
            }
          },
          "minPowerUnits": {
            "title": "Minimum power units",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum census power units (fleet size). The official fleetsize field is a letter class (A, B, C…) and is returned separately as fleetSizeClass."
          },
          "maxPowerUnits": {
            "title": "Maximum power units",
            "minimum": 0,
            "type": "integer",
            "description": "Only return carriers with at most this many power units (trucks/tractors) in the FMCSA census. Leave empty for no limit."
          },
          "activeCensusOnly": {
            "title": "Active census records only (census mode)",
            "type": "boolean",
            "description": "In census mode, keep status_code = A. Ignored in new-authorities mode so a grant is returned even if the census row is not marked active.",
            "default": true
          },
          "onlyNew": {
            "title": "Only new records since last run (monitor mode)",
            "type": "boolean",
            "description": "Later runs return only IDs not seen before under this monitor key. The first run bills up to maxItems as carrier-record events and seeds the rest of the current window without charging. Later new-authority runs bill new-authority events.",
            "default": false
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Label for this saved monitor (plain text, not a password or API key). When \"Only new\" monitor mode is on, the Actor remembers which records it has already delivered under this name and returns only new ones next time. Use a different name per filter set or client, for example \"client-a-weekly\". Older inputs that use monitorKey still work.",
            "default": "default"
          },
          "maxItems": {
            "title": "Maximum records",
            "minimum": 1,
            "maximum": 25000,
            "type": "integer",
            "description": "Default 25 (auto-test safe). Free Apify plans are capped at 15. Paid plans can go up to 25,000.",
            "default": 25
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}