Name: FMCSA Trucking Company Search API | Live Carrier Data
Brand: cblu
SKU: api-cblu-fmcsa-motor-carrier-search
Availability: InStock
Author: API Market

# FMCSA Motor Carrier Search API (Trucking Company Data)

## Overview
The FMCSA Motor Carrier Search API provides comprehensive access to the official US trucking carrier census, encompassing approximately 4.5 million carriers registered with the Federal Motor Carrier Safety Administration (FMCSA). This powerful API allows you to query the complete motor-carrier universe and retrieve detailed JSON records for each entry.

Every API call executes a live query against the official FMCSA Company Census File, sourced from the US DOT open-data portal (data.transportation.gov), ensuring that your data is refreshed roughly daily. This means you are always working with the freshest possible information, without relying on stale mirrored data or complex SAFER page scraping.

## Features
*   **Comprehensive Carrier Data**: Access vital information including USDOT number, legal and DBA names, business and cell phone numbers, email addresses, company officers, and full physical/mailing addresses.
*   **Fleet & Operations Details**: Get insights into fleet size with power units, trucks, drivers, and CDL drivers, along with cargo classifications and a hazmat flag.
*   **Safety & Compliance**: Retrieve the carrier's safety rating, the date of their last MCS-150 filing, and a direct link to their SAFER snapshot page for in-depth compliance checks.
*   **Live & Fresh Data**: Directly queries the official FMCSA Company Census File, which is updated approximately daily, providing real-time accuracy.
*   **Advanced Lead Generation Filters**: Precisely target carriers using a robust set of filters:
    *   Filter by US state of operation.
    *   Specify fleet-size bands (minimum/maximum power units) and minimum drivers.
    *   Filter by specific cargo types, or identify hazmat-only carriers.
    *   Target carriers based on their safety rating.
    *   Search by name substring (legal or DBA names).
    *   Require carriers to have an email or phone number on file.
    *   Define a registration-date window (e.g., `addedAfter` last week) to discover new carriers.
*   **Efficient Retrieval**: Typically returns results within 5–30 seconds, with support for up to 100 records per call.

## Use Cases
1.  **Lead Generation for Logistics & Brokerage**: Identify new or expanding trucking companies in specific regions or with certain fleet sizes for partnership opportunities or freight matching. For example, find carriers with 10-50 power units in Texas and Oklahoma that handle general freight and have an email address.
2.  **Insurance & Financial Services Targeting**: Pinpoint trucking businesses for tailored insurance policies, loans, or equipment financing based on their operational profile, fleet size, safety rating, and location.
3.  **Equipment Sales & Leasing**: Target potential customers for truck sales, trailer leasing, or maintenance services by filtering for carriers with specific fleet sizes or operating in target states.
4.  **Supply Chain Due Diligence & Vetting**: Verify carrier details, operational types, hazmat capabilities, and safety ratings for compliance, risk assessment, and informed decision-making in supply chain management.
5.  **Market Research & Competitive Analysis**: Analyze trucking industry trends, regional carrier density, and the growth of new businesses by leveraging filters like registration date and geographical location.


## Pricing
This API operates on a synchronous model, where each successful search query counts as 1 API unit. Different pricing tiers are available based on usage volume.

## API Documentation

### Base URL
All API requests should be made to:
`https://prod.api.market/api/v1/cblu/fmcsa-motor-carrier-search`

### Authentication
Authentication is handled via an API key. Include your API key in the request header:

```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Endpoints

#### POST /api/v1/cblu/fmcsa-motor-carrier-search/run-sync-get-dataset-items

**Summary:** Search US motor carriers registered with the FMCSA.

**Description:** Runs a live query against the official FMCSA Company Census File to retrieve matching trucking carrier records as a JSON array. You can filter by various criteria to narrow down your search results.

**Query Parameters:**
*   `clean` (boolean, optional, default: `true`): Return clean dataset items only (recommended).
*   `format` (string, optional, enum: `json`, `csv`, default: `json`): Response format.

**Request Body (application/json):**
At least one search criterion should be provided.

| Parameter          | Type             | Description                                                                                                                                              | Example Value(s)                                   |
| :----------------- | :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------- |
| `states`           | Array of strings | Two-letter US state codes for the carrier's primary address.                                                                                             | `["TX", "OK"]`                                     |
| `operationTypes`   | Array of strings | Type of operation.                                                                                                                                       | `["interstate", "intrastate"]`                     |
| `minPowerUnits`    | Integer          | Minimum number of power units in the fleet.                                                                                                              | `5`                                                |
| `maxPowerUnits`    | Integer          | Maximum number of power units in the fleet.                                                                                                              | `50`                                               |
| `minDrivers`       | Integer          | Minimum number of drivers employed by the carrier.                                                                                                       | `2`                                                |
| `cargoTypes`       | Array of strings | Specific cargo classifications, e.g., "General Freight", "Building Materials".                                                                           | `["General Freight"]`                              |
| `hazmatOnly`       | Boolean          | Set to `true` to only return carriers authorized for hazmat materials.                                                                                   | `true`                                             |
| `safetyRating`     | String           | Filter by safety rating. Possible values: "satisfactory", "conditional", "unsatisfactory", "unrated".                                                    | `"satisfactory"`                                   |
| `nameSubstring`    | String           | Search for legal or DBA names containing this substring (case-insensitive).                                                                              | `"express"`                                        |
| `hasEmail`         | Boolean          | Set to `true` to only return carriers with an email address on file.                                                                                     | `true`                                             |
| `hasPhone`         | Boolean          | Set to `true` to only return carriers with a phone number on file.                                                                                       | `true`                                             |
| `addedAfter`       | String (date)    | Return carriers registered after this ISO 8601 date (e.g., "2023-10-26"). Useful for identifying newly registered carriers.                               | `"2023-10-26"`                                     |
| `maxResults`       | Integer          | Maximum number of carrier records to return in this call (minimum: 1, maximum: 100, default: 50).                                                        | `25`                                               |

**Example Request:**
```bash
curl -X POST 'https://prod.api.market/api/v1/cblu/fmcsa-motor-carrier-search/run-sync-get-dataset-items' \
  -H 'x-api-market-key: YOUR_API_MARKET_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"states":["TX","OK"],"operationTypes":["interstate"],"minPowerUnits":5,"maxPowerUnits":50,"hasEmail":true,"maxResults":25}'
```

**Response (application/json):**
An array of carrier objects.

| Field                 | Type               | Description                                                                 | Example Value                       |
| :-------------------- | :----------------- | :-------------------------------------------------------------------------- | :---------------------------------- |
| `dotNumber`           | String             | The 10-digit USDOT Number, a stable unique identifier.                      | `"3128844"`                         |
| `legalName`           | String             | The legal name of the motor carrier.                                        | `"RED DIRT FREIGHT LLC"`            |
| `dbaName`             | String or null     | The "Doing Business As" (DBA) name of the carrier, if applicable.           | `null`                              |
| `phone`               | String or null     | The primary business phone number.                                          | `"(918) 555-0148"`                  |
| `cellPhone`           | String or null     | The cell phone number on file.                                              | `"(918) 555-0149"`                  |
| `email`               | String or null     | The email address on file for the carrier.                                  | `"dispatch@reddirtfreight.com"`     |
| `officers`            | Array of objects or null | A list of company officers or principals.                                   | `[{"name": "John Doe", "title": "CEO"}]` |
| `powerUnits`          | Integer or null    | The number of power units (trucks, tractors) in the fleet.                  | `12`                                |
| `trucks`              | Integer or null    | The total number of trucks in the fleet.                                    | `15`                                |
| `drivers`             | Integer or null    | The total number of drivers employed.                                       | `14`                                |
| `cdlDrivers`          | Integer or null    | The number of Commercial Driver's License (CDL) holders.                    | `14`                                |
| `cargoClassifications` | Array of strings or null | A list of cargo classifications handled by the carrier.                     | `["General Freight", "Oilfield Equipment"]` |
| `hazmatFlag`          | Boolean or null    | `true` if the carrier is authorized to transport hazardous materials.       | `false`                             |
| `safetyRating`        | String or null     | The carrier's safety rating (e.g., "Satisfactory", "Conditional", "Unsatisfactory", `null` if unrated). | `null`                              |
| `lastMCS150Filing`    | String (date) or null | The date of the carrier's last MCS-150 filing (ISO 8601 format).            | `"2023-09-15"`                      |
| `physicalAddress`     | String or null     | The full physical address of the carrier's primary place of business.       | `"1420 S Elm Pl, Broken Arrow, OK 74012"` |
| `mailingAddress`      | String or null     | The full mailing address of the carrier.                                    | `"PO Box 123, Broken Arrow, OK 74012"` |
| `saferSnapshotLink`   | String or null     | A direct URL link to the carrier's SAFER snapshot page on the FMCSA website. | `"https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=3128844"` |

**Example Response:**
```json
[
  {
    "dotNumber": "3128844",
    "legalName": "RED DIRT FREIGHT LLC",
    "phone": "(918) 555-0148",
    "email": "dispatch@reddirtfreight.com",
    "physicalAddress": "1420 S Elm Pl, Broken Arrow, OK 74012",
    "powerUnits": 12,
    "drivers": 14,
    "operationType": "interstate",
    "safetyRating": null
  }
]
```


## Implementation Guide

### Example Code
These examples demonstrate how to make a synchronous request to the FMCSA Motor Carrier Search API and process the results. All examples are for synchronous operations, meaning a single request returns the final result.

```javascript
// JavaScript example for synchronous API call
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/cblu/fmcsa-motor-carrier-search";
const endpointPath = "/run-sync-get-dataset-items";

async function searchMotorCarriers(inputData) {
  try {
    const response = await fetch(`${baseUrl}${endpointPath}`, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "x-api-market-key": apiKey
      },
      body: JSON.stringify(inputData)
    });
    
    // Check for HTTP errors
    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API error: ${response.status} ${response.statusText} - ${errorData.error.message || 'Unknown error'}`);
    }
    
    // Parse the JSON response directly
    const carriers = await response.json();
    return carriers;

  } catch (error) {
    console.error("Error searching motor carriers:", error);
    throw error;
  }
}

// Example usage:
const searchInput = {
  states: ["TX", "OK"],
  operationTypes: ["interstate"],
  minPowerUnits: 5,
  maxPowerUnits: 50,
  hasEmail: true,
  maxResults: 25
};

searchMotorCarriers(searchInput)
  .then(data => {
    console.log("Found carriers:", data);
  })
  .catch(error => {
    console.error("Failed to search carriers:", error);
  });
```

```python
# Python example for synchronous API call
import requests
import json

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/cblu/fmcsa-motor-carrier-search"
ENDPOINT_PATH = "/run-sync-get-dataset-items"

def search_motor_carries(input_data):
    headers = {
        "Content-Type": "application/json",
        "x-api-market-key": API_KEY
    }
    
    try:
        response = requests.post(
            f"{BASE_URL}{ENDPOINT_PATH}",
            headers=headers,
            json=input_data,
            timeout=60 # Recommend a timeout for synchronous calls
        )
        
        # Check for HTTP errors
        response.raise_for_status() 
        
        # Parse the JSON response directly
        carriers = response.json()
        return carriers

    except requests.exceptions.HTTPError as e:
        error_data = e.response.json()
        print(f"API HTTP error: {e.response.status_code} {e.response.reason} - {error_data.get('error', {}).get('message', 'Unknown error')}")
        raise
    except requests.exceptions.RequestException as e:
        print(f"Request error: {e}")
        raise

# Example usage:
search_input = {
    "states": ["TX", "OK"],
    "operationTypes": ["interstate"],
    "minPowerUnits": 5,
    "maxPowerUnits": 50,
    "hasEmail": True,
    "maxResults": 25
}

try:
    found_carriers = search_motor_carries(search_input)
    print("Found carriers:", json.dumps(found_carriers, indent=2))
except Exception as e:
    print("Failed to search carriers:", e)
```

```bash
# cURL example for synchronous API call
curl -X POST 'https://prod.api.market/api/v1/cblu/fmcsa-motor-carrier-search/run-sync-get-dataset-items' \
  -H 'x-api-market-key: YOUR_API_MARKET_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "states":["TX","OK"],
    "operationTypes":["interstate"],
    "minPowerUnits":5,
    "maxPowerUnits":50,
    "hasEmail":true,
    "maxResults":25
  }'
```



## FAQ
**What is the data source for this API?**

Every call queries the official FMCSA Company Census File, which is part of the US DOT open-data portal (data.transportation.gov).

**How fresh is the data?**

The FMCSA Company Census File is refreshed roughly daily by the US DOT, ensuring you get very fresh data.

**What filters are available for searching?**

You can filter by state, fleet-size band (min/max power units), minimum drivers, cargo types, hazmat-only status, safety rating, name substring, requirement for email/phone, and a registration-date window (`addedAfter`).

**What is the typical response time?**

Typical response times are between 5–30 seconds, as every call involves a live query.

**What is the maximum number of records I can retrieve per call?**

You can retrieve up to 100 records per API call.

**Why do I get few results when combining `cargoTypes` with a very recent `addedAfter` filter?**

The FMCSA typically fills in cargo-classification flags about 2 months after a carrier first registers. Therefore, combining a `cargoTypes` filter with a very recent `addedAfter` filter will legitimately return fewer rows, as newer carriers may not yet have their cargo types classified in the official data.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.

Search 4.5M US trucking companies via the FMCSA Motor Carrier Search API. Access live DOT, phone, email, fleet, and safety data, refreshed daily for lead genera

FMCSA Trucking Company Search API | Live Carrier Data

Free

CBLU

Basic

Ultra

Query the complete 4.5M US trucking carrier universe live, retrieving DOT, phone, email, and safety data, refreshed daily with 5-30 second response times.