{
  "openapi": "3.0.1",
  "info": {
    "title": "FMCSA New Carrier Feed: New Trucking Companies & MC Authority",
    "description": "Daily feed of new US motor carriers (new USDOT numbers), new FMCSA authority grants (MC, brokers, freight forwarders) and suspensions/revocations from official FMCSA open data. Legal entities only. Filter by state, fleet size, interstate/intrastate, hazmat, cargo.",
    "version": "0.1",
    "x-build-id": "qrNBU4sL0hZ6ijbQk"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/moment-data~fmcsa-new-carrier-feed/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-moment-data-fmcsa-new-carrier-feed",
        "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/moment-data~fmcsa-new-carrier-feed/runs": {
      "post": {
        "operationId": "runs-sync-moment-data-fmcsa-new-carrier-feed",
        "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/moment-data~fmcsa-new-carrier-feed/run-sync": {
      "post": {
        "operationId": "run-sync-moment-data-fmcsa-new-carrier-feed",
        "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": [
              "window",
              "sinceLastRun"
            ],
            "type": "string",
            "description": "window (default): events in the last N days, no saved state. sinceLastRun: only events not delivered before for this State key; use this for daily schedules.",
            "default": "window"
          },
          "eventTypes": {
            "title": "Event types",
            "type": "array",
            "description": "Empty = all three. newCarriers: new USDOT registrations (FMCSA Company Census add date). authorityGranted: new operating authority granted (MC/FF docket; carriers, brokers, freight forwarders). authorityRevoked: authority suspension and revocation orders served.",
            "items": {
              "type": "string"
            }
          },
          "states": {
            "title": "States",
            "type": "array",
            "description": "2-letter codes of the carrier's physical address, e.g. TX, CA, CO (Canadian provinces and Mexican states also work, e.g. ON). Empty = all.",
            "items": {
              "type": "string"
            }
          },
          "minPowerUnits": {
            "title": "Min power units (fleet size)",
            "minimum": 0,
            "type": "integer",
            "description": "Only carriers reporting at least this many power units (trucks/tractors/buses) on their MCS-150. Note: brand-new carriers often report 1-2 units and brokers report 0. Empty or 0 = no minimum."
          },
          "maxPowerUnits": {
            "title": "Max power units",
            "minimum": 0,
            "type": "integer",
            "description": "Only carriers with at most this many power units. Empty or 0 = no maximum."
          },
          "operationTypes": {
            "title": "Operation type",
            "type": "array",
            "description": "interstate, intrastate (both kinds), intrastate-hazmat, intrastate-non-hazmat. Empty = all.",
            "items": {
              "type": "string"
            }
          },
          "hazmatOnly": {
            "title": "Hazmat carriers only",
            "type": "boolean",
            "description": "Only carriers flagged as hauling hazardous materials.",
            "default": false
          },
          "cargoTypes": {
            "title": "Cargo types",
            "type": "array",
            "description": "Carrier hauls ANY of these (MCS-150 cargo classifications): generalFreight, householdGoods, metalSheetsCoilsRolls, motorVehicles, driveawayTowaway, logsPolesLumber, buildingMaterials, mobileHomes, machineryLargeObjects, freshProduce, liquidsGases, intermodalContainers, passengers, oilfieldEquipment, livestock, grainFeedHay, coalCoke, meat, garbageRefuse, usMail, chemicals, dryBulk, refrigeratedFood, beverages, paperProducts, utilities, farmSupplies, construction, waterWell, other.",
            "items": {
              "type": "string"
            }
          },
          "authorityTypes": {
            "title": "Authority types (grants/revocations)",
            "type": "array",
            "description": "Filter authorityGranted / authorityRevoked by authority: property, householdGoods, passengers, broker, freightForwarder, mexicoDomiciled. Empty = all. Does not affect newCarriers.",
            "items": {
              "type": "string"
            }
          },
          "daysBack": {
            "title": "Days back",
            "minimum": 1,
            "maximum": 120,
            "type": "integer",
            "description": "Lookback window in days (by registration date, grant date or order serve date). In window mode an empty window is widened to 14, 30, 60 and then 120 days. Also the first-run window in sinceLastRun mode.",
            "default": 7
          },
          "maxItems": {
            "title": "Max records per run",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Hard cap on delivered records (also caps your spend). With several event types the cap is shared round-robin, newest first.",
            "default": 30
          },
          "autoExtend": {
            "title": "Widen an empty window (window mode)",
            "type": "boolean",
            "description": "If nothing matches in Days back, retry with 14, 30, 60 and 120 days so you always see the latest matching events.",
            "default": true
          },
          "stateKey": {
            "title": "State key",
            "type": "string",
            "description": "Name of the saved feed for sinceLastRun mode. Each key keeps its own history, so use one key per schedule or filter set.",
            "default": "default"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}