---
type: "firecrawl-provider"
description: "FMCSA's public motor carrier safety data: the SAFER Company Snapshot system (safer.fmcsa.dot.gov: carrier name search, Company Snapshot by USDOT or MC/MX number with identity, authority, fleet size, drivers, cargo, 24-month inspection/out-of-service/crash counts and safety rating) and the Safety Measurement System (ai.fmcsa.dot.gov/SMS: paginated carrier search with power units, inspection and crash totals, carrier overview with BASIC status, investigations and activity summary, the per-carrier XML export of individual inspections, violations and crashes, and name autocomplete). Anonymous, read-only; Licensing & Insurance (li-public, reCAPTCHA) and the QCMobile API (registered key) are not covered."
use_when: "FMCSA's public motor carrier safety data: the SAFER Company Snapshot system (safer.fmcsa.dot.gov: carrier name search, Company Snapshot by USDOT or MC/MX number with identity, authority, fleet size, drivers, cargo, 24-month inspection/out-of-service/crash counts and safety rating) and the Safety Measurement System (ai.fmcsa.dot.gov/SMS: paginated carrier search with power units, inspection and crash totals, carrier overview with BASIC status, investigations and activity summary, the per-carrier XML export of individual inspections, violations and crashes, and name autocomplete). Anonymous, read-only; Licensing & Insurance (li-public, reCAPTCHA) and the QCMobile API (registered key) are not covered."
categories: "Public records"
capabilities: 6
credits_per_call: 5
---
# FMCSA SAFER and SMS carrier registry on Firecrawl Alexandria

FMCSA's public motor carrier safety data: the SAFER Company Snapshot system (safer.fmcsa.dot.gov: carrier name search, Company Snapshot by USDOT or MC/MX number with identity, authority, fleet size, drivers, cargo, 24-month inspection/out-of-service/crash counts and safety rating) and the Safety Measurement System (ai.fmcsa.dot.gov/SMS: paginated carrier search with power units, inspection and crash totals, carrier overview with BASIC status, investigations and activity summary, the per-carrier XML export of individual inspections, violations and crashes, and name autocomplete). Anonymous, read-only; Licensing & Insurance (li-public, reCAPTCHA) and the QCMobile API (registered key) are not covered.

- Categories: Public records
- Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records)
- Provider key: `safer-fmcsa-dot-gov`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/safer-fmcsa-dot-gov)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/safer-fmcsa-dot-gov/openapi.json)

## Capabilities

- [Get carrier snapshot](https://firecrawl.dev/alexandria/agents/providers/safer-fmcsa-dot-gov/carriers/get_carrier_snapshot): SAFER Company Snapshot (query.asp) for one carrier by USDOT number or MC/MX docket number: entity type, USDOT and operating authority status, out-of-service date, MCS-150 form date and mileage, docket numbers, legal/DBA names, addresses, phone, DUNS, power units, non-CMV units, drivers, operation classification, carrier operation, cargo carried, US and Canadian 24-month inspection/out-of-service/crash counts with national OOS averages, the federal safety rating, and the system's as-of date. `usdot_number` also accepts a pasted SAFER query.asp or SMS carrier URL.
- [Get sms overview](https://firecrawl.dev/alexandria/agents/providers/safer-fmcsa-dot-gov/carriers/get_sms_overview): SMS carrier overview (ai.fmcsa.dot.gov/SMS/Carrier/{dot}/Overview.aspx): legal name, address, number of vehicles, drivers and inspections, the 24-month record end date, the seven BASICs with their public/not-public flag and detail URLs, the five most recent investigations, inspection totals with and without violations, driver/vehicle/hazmat inspection counts with out-of-service rates, fatal/injury/tow-away crash counts, registration flags and the enforcement-cases note. `usdot_number` also accepts a pasted SMS carrier URL.
- [Get sms safety records](https://firecrawl.dev/alexandria/agents/providers/safer-fmcsa-dot-gov/carriers/get_sms_safety_records): SMS per-carrier export (ai.fmcsa.dot.gov/SMS/Carrier/{dot}/Download.aspx, XML): every roadside inspection of the 24-month record with its vehicles and violations, every reportable crash with its vehicle, and serious violations, optionally restricted to one BASIC. The site exports everything at once (several MB for large fleets); this function pages the records client-side, 50 per call, inspections first, then crashes, then serious violations, with totals of each and the export's snapshot date.
- [Search carriers](https://firecrawl.dev/alexandria/agents/providers/safer-fmcsa-dot-gov/carriers/search_carriers): SAFER carrier name search (keywordx.asp): every carrier whose legal or DBA name contains the text, with its USDOT number, city/state and Company Snapshot URL. The site returns at most 500 matches and has no paging; `truncated` is true (and coverage partial) when that cap was hit, so narrow the name. A name that matches nothing is a successful empty result.
- [Search sms carriers](https://firecrawl.dev/alexandria/agents/providers/safer-fmcsa-dot-gov/carriers/search_sms_carriers): SMS carrier search (ai.fmcsa.dot.gov/SMS/Search): carriers whose name contains the query, 50 per page with the total count, each with USDOT number, legal and DBA names, operation, country, service center, state, county, city, passenger/hazmat/new-entrant flags, power units, total inspections and total crashes (24 months). Page 1 is the search form's POST; later pages are the site's SimpleSearchResults fragment, reached with the returned continuation cursor. A query that is a bare USDOT number is resolved by the site to that one carrier. A query that matches nothing is a successful empty result.
- [Suggest sms carrier names](https://firecrawl.dev/alexandria/agents/providers/safer-fmcsa-dot-gov/carriers/suggest_sms_carrier_names): SMS carrier-name autocomplete (ToolbarHint.aspx): the name prefixes the SMS search box proposes for at least three typed characters, about ten strings.

## 1. Choose this provider when

FMCSA's public motor carrier safety data: the SAFER Company Snapshot system (safer.fmcsa.dot.gov: carrier name search, Company Snapshot by USDOT or MC/MX number with identity, authority, fleet size, drivers, cargo, 24-month inspection/out-of-service/crash counts and safety rating) and the Safety Measurement System (ai.fmcsa.dot.gov/SMS: paginated carrier search with power units, inspection and crash totals, carrier overview with BASIC status, investigations and activity summary, the per-carrier XML export of individual inspections, violations and crashes, and name autocomplete). Anonymous, read-only; Licensing & Insurance (li-public, reCAPTCHA) and the QCMobile API (registered key) are not covered.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "safer-fmcsa-dot-gov",
  "capability": "carriers/get_carrier_snapshot",
  "options": {
    "usdot_number": "53467"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `mc_mx_number` (string): MC or MX docket number, digits with an optional MC-/MX- prefix (`MC-138328` or `138328`). One of usdot_number or mc_mx_number. Example: `MC-138328`
- `usdot_number` (string): USDOT number (digits), or a SAFER query.asp / SMS /SMS/Carrier/{dot}/ URL. One of usdot_number or mc_mx_number. Example: `<usdot_number>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "safer-fmcsa-dot-gov",
    capability: "carriers/get_carrier_snapshot",
    options: {
      usdot_number: "53467",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "safer-fmcsa-dot-gov",
  "capability": "carriers/get_carrier_snapshot",
  "options": {
    "usdot_number": "53467"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "safer-fmcsa-dot-gov",
    "capability": "carriers/get_carrier_snapshot",
    "options": {
      "usdot_number": "53467"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'safer-fmcsa-dot-gov/carriers/get_carrier_snapshot' \
  --options '{"usdot_number":"53467"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "safer-fmcsa-dot-gov",
  "capability": "carriers/get_carrier_snapshot",
  "options": {
    "usdot_number": "53467"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "safer-fmcsa-dot-gov",
  "capability": "carriers/get_carrier_snapshot",
  "options": {
    "usdot_number": "53467"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "authorized_for": [
    "Motor Carrier of Property (Except Household Goods)",
    "Broker of Property (Except Household Goods)"
  ],
  "canada_crashes": {
    "as_of": "2026-10-02",
    "fatal": 0,
    "injury": 0,
    "total": 0,
    "tow": 0
  },
  "canada_inspections": {
    "as_of": "2026-10-02",
    "inspections": {
      "driver": 1,
      "vehicle": 0
    },
    "out_of_service": {
      "driver": 0,
      "vehicle": 0
    },
    "out_of_service_pct": {
      "driver": 0,
      "vehicle": 20
    },
    "total": 1
  },
  "cargo_carried": [
    "General Freight",
    "Metal: sheets, coils, rolls",
    "Building Materials",
    "Machinery, Large Objects",
    "Fresh Produce",
    "Liquids/Gases",
    "Intermodal Cont.",
    "Passengers",
    "Grain, Feed, Hay",
    "Chemicals",
    "Commodities Dry Bulk",
    "Refrigerated Food",
    "Beverages",
    "Paper Products",
    "Construction"
  ],
  "carrier_operation": [
    "Interstate"
  ],
  "data_as_of": "2026-10-02",
  "data_notes": [
    "Carrier Registration Information Outdated",
    "Carrier VMT Outdated"
  ],
  "dba_name": null,
  "docket_numbers": [
    "MC-138328"
  ],
  "drivers": 9107,
  "duns_number": "22-086-565",
  "entity_type": "CARRIER/BROKER",
  "legal_name": "WERNER ENTERPRISES INC",
  "licensing_url": "https://motus.dot.gov/customer/53467/account",
  "mailing_address": "PO BOX 45308, OMAHA, NE 68145-0308",
  "mailing_address_lines": [
    "PO BOX 45308",
    "OMAHA, NE 68145-0308"
  ],
  "mcs150_form_date": "2024-07-23",
  "mcs150_mileage": {
    "miles": 796071597,
    "year": 2023
  },
  "non_cmv_units": 0,
  "observed_at_ms": 1791157490203,
  "operating_authority_status": "AUTHORIZED FOR",
  "operation_classification": [
    "Auth. For Hire",
    "Private(Property)"
  ],
  "out_of_service_date": null,
  "phone": "(402) 895-6640",
  "physical_address": "14507 FRONTIER ROAD, OMAHA, NE 68138",
  "physical_address_lines": [
    "14507 FRONTIER ROAD",
    "OMAHA, NE 68138"
  ],
  "power_units": 9863,
  "requested": {
    "param": "USDOT",
    "value": "53467"
  },
  "safety_rating": {
    "as_of": "2026-10-02",
    "rating": "Satisfactory",
    "rating_date": "1995-08-08",
    "review_date": "2024-11-15",
    "type": "Non-Ratable"
  },
  "sms_url": "https://ai.fmcsa.dot.gov/SMS/Carrier/53467/Overview.aspx",
  "source_url": "https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=53467",
  "state_carrier_id": null,
  "us_crashes": {
    "as_of": "2026-10-02",
    "fatal": 12,
    "injury": 220,
    "total": 677,
    "tow": 445
  },
  "us_inspections": {
    "as_of": "2026-10-02",
    "inspections": {
      "driver": 11642,
      "hazmat": 338,
      "iep": 0,
      "vehicle": 6253
    },
    "national_average_as_of": "2026-08-28",
    "national_average_pct": {
      "driver": 6.67,
      "hazmat": 4.44,
      "iep": null,
      "vehicle": 22.26
    },
    "out_of_service": {
      "driver": 113,
      "hazmat": 8,
      "iep": 0,
      "vehicle": 1251
    },
    "out_of_service_pct": {
      "driver": 1,
      "hazmat": 2.4,
      "iep": 0,
      "vehicle": 20
    },
    "total": 11655,
    "total_iep": 0
  },
  "usdot_number": "53467",
  "usdot_status": "ACTIVE"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Get carrier snapshot

- Capability: `carriers/get_carrier_snapshot`
- Description: SAFER Company Snapshot (query.asp) for one carrier by USDOT number or MC/MX docket number: entity type, USDOT and operating authority status, out-of-service date, MCS-150 form date and mileage, docket numbers, legal/DBA names, addresses, phone, DUNS, power units, non-CMV units, drivers, operation classification, carrier operation, cargo carried, US and Canadian 24-month inspection/out-of-service/crash counts with national OOS averages, the federal safety rating, and the system's as-of date. `usdot_number` also accepts a pasted SAFER query.asp or SMS carrier URL.
- Instructions: You have a USDOT or MC/MX number (from search_carriers, search_sms_carriers or elsewhere) and need the carrier's registration, fleet and safety summary.
- Cost: 5 credits per call
- Capability file: [Get carrier snapshot](https://firecrawl.dev/alexandria/agents/providers/safer-fmcsa-dot-gov/carriers/get_carrier_snapshot)

Accepted options:
- `mc_mx_number` (string): MC or MX docket number, digits with an optional MC-/MX- prefix (`MC-138328` or `138328`). One of usdot_number or mc_mx_number. Example: `MC-138328`
- `usdot_number` (string): USDOT number (digits), or a SAFER query.asp / SMS /SMS/Carrier/{dot}/ URL. One of usdot_number or mc_mx_number. Example: `<usdot_number>`

Response schema example:
```json
{
  "authorized_for": [
    "Motor Carrier of Property (Except Household Goods)",
    "Broker of Property (Except Household Goods)"
  ],
  "canada_crashes": {
    "as_of": "2026-10-02",
    "fatal": 0,
    "injury": 0,
    "total": 0,
    "tow": 0
  },
  "canada_inspections": {
    "as_of": "2026-10-02",
    "inspections": {
      "driver": 1,
      "vehicle": 0
    },
    "out_of_service": {
      "driver": 0,
      "vehicle": 0
    },
    "out_of_service_pct": {
      "driver": 0,
      "vehicle": 20
    },
    "total": 1
  },
  "cargo_carried": [
    "General Freight",
    "Metal: sheets, coils, rolls",
    "Building Materials",
    "Machinery, Large Objects",
    "Fresh Produce",
    "Liquids/Gases",
    "Intermodal Cont.",
    "Passengers",
    "Grain, Feed, Hay",
    "Chemicals",
    "Commodities Dry Bulk",
    "Refrigerated Food",
    "Beverages",
    "Paper Products",
    "Construction"
  ],
  "carrier_operation": [
    "Interstate"
  ],
  "data_as_of": "2026-10-02",
  "data_notes": [
    "Carrier Registration Information Outdated",
    "Carrier VMT Outdated"
  ],
  "dba_name": null,
  "docket_numbers": [
    "MC-138328"
  ],
  "drivers": 9107,
  "duns_number": "22-086-565",
  "entity_type": "CARRIER/BROKER",
  "legal_name": "WERNER ENTERPRISES INC",
  "licensing_url": "https://motus.dot.gov/customer/53467/account",
  "mailing_address": "PO BOX 45308, OMAHA, NE 68145-0308",
  "mailing_address_lines": [
    "PO BOX 45308",
    "OMAHA, NE 68145-0308"
  ],
  "mcs150_form_date": "2024-07-23",
  "mcs150_mileage": {
    "miles": 796071597,
    "year": 2023
  },
  "non_cmv_units": 0,
  "observed_at_ms": 1791157490203,
  "operating_authority_status": "AUTHORIZED FOR",
  "operation_classification": [
    "Auth. For Hire",
    "Private(Property)"
  ],
  "out_of_service_date": null,
  "phone": "(402) 895-6640",
  "physical_address": "14507 FRONTIER ROAD, OMAHA, NE 68138",
  "physical_address_lines": [
    "14507 FRONTIER ROAD",
    "OMAHA, NE 68138"
  ],
  "power_units": 9863,
  "requested": {
    "param": "USDOT",
    "value": "53467"
  },
  "safety_rating": {
    "as_of": "2026-10-02",
    "rating": "Satisfactory",
    "rating_date": "1995-08-08",
    "review_date": "2024-11-15",
    "type": "Non-Ratable"
  },
  "sms_url": "https://ai.fmcsa.dot.gov/SMS/Carrier/53467/Overview.aspx",
  "source_url": "https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=53467",
  "state_carrier_id": null,
  "us_crashes": {
    "as_of": "2026-10-02",
    "fatal": 12,
    "injury": 220,
    "total": 677,
    "tow": 445
  },
  "us_inspections": {
    "as_of": "2026-10-02",
    "inspections": {
      "driver": 11642,
      "hazmat": 338,
      "iep": 0,
      "vehicle": 6253
    },
    "national_average_as_of": "2026-08-28",
    "national_average_pct": {
      "driver": 6.67,
      "hazmat": 4.44,
      "iep": null,
      "vehicle": 22.26
    },
    "out_of_service": {
      "driver": 113,
      "hazmat": 8,
      "iep": 0,
      "vehicle": 1251
    },
    "out_of_service_pct": {
      "driver": 1,
      "hazmat": 2.4,
      "iep": 0,
      "vehicle": 20
    },
    "total": 11655,
    "total_iep": 0
  },
  "usdot_number": "53467",
  "usdot_status": "ACTIVE"
}
```

### Get sms overview

- Capability: `carriers/get_sms_overview`
- Description: SMS carrier overview (ai.fmcsa.dot.gov/SMS/Carrier/{dot}/Overview.aspx): legal name, address, number of vehicles, drivers and inspections, the 24-month record end date, the seven BASICs with their public/not-public flag and detail URLs, the five most recent investigations, inspection totals with and without violations, driver/vehicle/hazmat inspection counts with out-of-service rates, fatal/injury/tow-away crash counts, registration flags and the enforcement-cases note. `usdot_number` also accepts a pasted SMS carrier URL.
- Instructions: You have a USDOT number and need the SMS safety performance view (BASICs, investigations, inspection and crash breakdown) rather than SAFER's registration snapshot.
- Cost: 5 credits per call
- Capability file: [Get sms overview](https://firecrawl.dev/alexandria/agents/providers/safer-fmcsa-dot-gov/carriers/get_sms_overview)

Accepted options:
- `usdot_number` (string, required): USDOT number (digits) or an SMS /SMS/Carrier/{dot}/ URL. Example: `<usdot_number>`

Response schema example:
```json
{
  "activities_as_of": "2026-08-28",
  "address": "14507 FRONTIER ROAD, OMAHA, NE 68138",
  "address_lines": [
    "14507 FRONTIER ROAD",
    "OMAHA, NE 68138"
  ],
  "basics": [
    {
      "key": "UnsafeDriving",
      "name": "Unsafe Driving",
      "public": true,
      "url": "https://ai.fmcsa.dot.gov/SMS/Carrier/53467/BASIC/UnsafeDriving.aspx"
    },
    {
      "key": "CrashIndicator",
      "name": "Crash Indicator",
      "public": false,
      "url": "https://ai.fmcsa.dot.gov/SMS/Carrier/53467/BASIC/CrashIndicator.aspx"
    },
    {
      "key": "HOSCompliance",
      "name": "Hours-of-Service Compliance",
      "public": true,
      "url": "https://ai.fmcsa.dot.gov/SMS/Carrier/53467/BASIC/HOSCompliance.aspx"
    },
    {
      "key": "VehicleMaint",
      "name": "Vehicle Maintenance",
      "public": true,
      "url": "https://ai.fmcsa.dot.gov/SMS/Carrier/53467/BASIC/VehicleMaint.aspx"
    },
    {
      "key": "DrugsAlcohol",
      "name": "Controlled Substances and Alcohol",
      "public": true,
      "url": "https://ai.fmcsa.dot.gov/SMS/Carrier/53467/BASIC/DrugsAlcohol.aspx"
    },
    {
      "key": "HMCompliance",
      "name": "Hazardous Materials Compliance",
      "public": false,
      "url": "https://ai.fmcsa.dot.gov/SMS/Carrier/53467/BASIC/HMCompliance.aspx"
    },
    {
      "key": "DriverFitness",
      "name": "Driver Fitness",
      "public": true,
      "url": "https://ai.fmcsa.dot.gov/SMS/Carrier/53467/BASIC/DriverFitness.aspx"
    }
  ],
  "complete_profile_url": "https://ai.fmcsa.dot.gov/SMS/Carrier/53467/CompleteProfile.aspx",
  "crash_summary": {
    "fatal_crashes": {
      "count": 12
    },
    "injury_crashes": {
      "count": 213
    },
    "towaway_crashes": {
      "count": 458
    }
  },
  "download_url": "https://ai.fmcsa.dot.gov/SMS/Carrier/53467/Download.aspx?BASIC=0&FileType=XML",
  "drivers": 9107,
  "enforcement_cases": "No penalties found",
  "enforcement_cases_as_of": "2026-10-03",
  "inspection_summary": {
    "driver_inspections": {
      "count": 11506,
      "out_of_service_pct": 0.9
    },
    "pct_placardable_hm_inspections": {
      "pct": 2
    },
    "placardable_hm_inspections": {
      "count": 121,
      "out_of_service_pct": 6.6
    },
    "vehicle_inspections": {
      "count": 6137,
      "out_of_service_pct": 19.7
    }
  },
  "inspections": 11519,
  "inspections_with_violations": 3681,
  "inspections_without_violations": 7838,
  "investigations": [
    {
      "date": "2015-02-25",
      "date_text": "2/25/2015",
      "type": "Non-Ratable Review"
    },
    {
      "date": "2012-08-23",
      "date_text": "8/23/2012",
      "type": "Non-Ratable Review"
    },
    {
      "date": "2012-05-01",
      "date_text": "5/1/2012",
      "type": "Non-Ratable Review"
    },
    {
      "date": "1995-08-04",
      "date_text": "8/4/1995",
      "type": "Compliance Review"
    },
    {
      "date": "1992-10-08",
      "date_text": "10/8/1992",
      "type": "Compliance Review"
    }
  ],
  "legal_name": "WERNER ENTERPRISES INC",
  "most_recent_investigation": {
    "date": "2015-02-25",
    "date_text": "2/25/2015",
    "type": "Non-Ratable Review"
  },
  "observed_at_ms": 1791157532415,
  "record_end_date": "2026-08-28",
  "registration_flags": [],
  "snapshot_url": "https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=53467",
  "source_url": "https://ai.fmcsa.dot.gov/SMS/Carrier/53467/Overview.aspx",
  "total_crashes": 683,
  "total_inspections": 11519,
  "usdot_number": "53467",
  "vehicles": 9851
}
```

### Get sms safety records

- Capability: `carriers/get_sms_safety_records`
- Description: SMS per-carrier export (ai.fmcsa.dot.gov/SMS/Carrier/{dot}/Download.aspx, XML): every roadside inspection of the 24-month record with its vehicles and violations, every reportable crash with its vehicle, and serious violations, optionally restricted to one BASIC. The site exports everything at once (several MB for large fleets); this function pages the records client-side, 50 per call, inspections first, then crashes, then serious violations, with totals of each and the export's snapshot date.
- Instructions: You need the individual inspections, violations or crashes behind a carrier's SMS totals.
- Cost: 5 credits per call
- Capability file: [Get sms safety records](https://firecrawl.dev/alexandria/agents/providers/safer-fmcsa-dot-gov/carriers/get_sms_safety_records)

Accepted options:
- `basic` (string): Restrict the export to one BASIC (the site's Download focus). Default all. crash_indicator exports crashes only. Example: `all`
- `continuation` (string): Opaque cursor from a previous call's meta.page.next_cursor (the record offset); omit for the first page. Example: `<continuation>`
- `usdot_number` (string, required): USDOT number (digits) or an SMS /SMS/Carrier/{dot}/ URL. Example: `<usdot_number>`

Response schema example:
```json
{
  "basic": {
    "code": 0,
    "name": "All"
  },
  "count": 4,
  "crashes": [],
  "inspections": [
    {
      "hazmat_inspection": false,
      "inspection_date": "2025-11-19",
      "level": 2,
      "placardable_hazmat_vehicle_inspection": false,
      "report_number": "WI2346000341",
      "report_state": "WI",
      "time_weight": 2,
      "vehicles": [
        {
          "license_number": "TS62324",
          "license_state": "WI",
          "unit": 1,
          "unit_type": "Truck Tractor",
          "vin": "1XP7DB9X05D871994"
        },
        {
          "license_number": "843357",
          "license_state": "WI",
          "unit": 2,
          "unit_type": "Semi-Trailer",
          "vin": "1W1MAFYW94A239062"
        }
      ],
      "violations": [
        {
          "basic": "Vehicle Maint.",
          "code": "393.11B-CSSRR",
          "convicted_of_different_charge": false,
          "description": "Conspicuity Systems - Trailers, side retro reflective sheeting inadequate on vehicle manufactured on or after December 1, 1993",
          "out_of_service": false,
          "time_severity_weight": 3,
          "unit": "2"
        },
        {
          "basic": "Vehicle Maint.",
          "code": "396.3A1-BALR",
          "convicted_of_different_charge": false,
          "description": "Air Brake - Fails air loss rate test",
          "out_of_service": true,
          "time_severity_weight": 6,
          "unit": "1"
        },
        {
          "basic": "Vehicle Maint.",
          "code": "396.3A1-BALAC",
          "convicted_of_different_charge": false,
          "description": "Brake - Audible air leak from a brake chamber",
          "out_of_service": false,
          "time_severity_weight": 4,
          "unit": "1"
        },
        {
          "basic": "Vehicle Maint.",
          "code": "393.9A-LTSI",
          "convicted_of_different_charge": false,
          "description": "Lighting - Turn signal - Any inoperative on the rearmost vehicle.",
          "out_of_service": true,
          "time_severity_weight": 8,
          "unit": "2"
        },
        {
          "basic": "Vehicle Maint.",
          "code": "393.9A-LSML",
          "convicted_of_different_charge": false,
          "description": "Lighting - Side marker lamp(s) inoperative",
          "out_of_service": false,
          "time_severity_weight": 2,
          "unit": "2"
        },
        {
          "basic": "Vehicle Maint.",
          "code": "393.9A-LSLIWR",
          "convicted_of_different_charge": false,
          "description": "Lighting - Stop lamps - Both inoperative when required to be on",
          "out_of_service": true,
          "time_severity_weight": 8,
          "unit": "2"
        },
        {
          "basic": "Vehicle Maint.",
          "code": "393.9A-LIL",
          "convicted_of_different_charge": false,
          "description": "Lighting - Identification lamp(s) inoperative",
          "out_of_service": false,
          "time_severity_weight": 2,
          "unit": "2"
        },
        {
          "basic": "Vehicle Maint.",
          "code": "393.95A1",
          "convicted_of_different_charge": false,
          "description": "Emergency Equipment - Fire Extinguishers - no fire extinguisher present or not properly rated.",
          "out_of_service": false,
          "time_severity_weight": 2,
          "unit": "1"
        },
        {
          "basic": "Vehicle Maint.",
          "code": "393.55D2-B",
          "convicted_of_different_charge": false,
          "description": "Air Brake - ABS malfunction lamp defective on truck-tractor manufactured on or after March 1, 2001 for towed vehicle.",
          "out_of_service": false,
          "time_severity_weight": 4,
          "unit": "2"
        },
        {
          "basic": "Vehicle Maint.",
          "code": "393.55D1-B",
          "convicted_of_different_charge": false,
          "description": "Air Brake - ABS malfunction lamp defective on truck-tractor manufactured on or after March 1, 1997 and each single unit CMV on or after 1998.",
          "out_of_service": false,
          "time_severity_weight": 4,
          "unit": "1"
        }
      ]
    },
    {
      "hazmat_inspection": false,
      "inspection_date": "2025-12-17",
      "level": 2,
      "placardable_hazmat_vehicle_inspection": false,
      "report_number": "WI2346000402",
      "report_state": "WI",
      "time_weight": 2,
      "vehicles": [
        {
          "license_number": "TS62322",
          "license_state": "WI",
          "unit": 1,
          "unit_type": "Truck Tractor",
          "vin": "1XP5DB9X25N856835"
        },
        {
          "license_number": "869490",
          "license_state": "WI",
          "unit": 2,
          "unit_type": "Semi-Trailer",
          "vin": "1W1MAF1AX2A235615"
        }
      ],
      "violations": [
        {
          "basic": "Unsafe Driving",
          "code": "392.2-SLLS3",
          "convicted_of_different_charge": false,
          "description": "State/Local Laws - Speeding 11-14 miles per hour over the speed limit",
          "out_of_service": false,
          "time_severity_weight": 7,
          "unit": "D"
        },
        {
          "basic": "Vehicle Maint.",
          "code": "396.3A1-BALR",
          "convicted_of_different_charge": false,
          "description": "Air Brake - Fails air loss rate test",
          "out_of_service": true,
          "time_severity_weight": 6,
          "unit": "2"
        },
        {
          "basic": "Vehicle Maint.",
          "code": "396.3A1-BALAC",
          "convicted_of_different_charge": false,
          "description": "Brake - Audible air leak from a brake chamber",
          "out_of_service": false,
          "time_severity_weight": 4,
          "unit": "2"
        },
        {
          "basic": "Vehicle Maint.",
          "code": "393.55E-B",
          "convicted_of_different_charge": false,
          "description": "Air Brake - ABS malfunction lamp defective on trailers manufactured on or after March 1, 1998",
          "out_of_service": false,
          "time_severity_weight": 4,
          "unit": "2"
        },
        {
          "basic": "Vehicle Maint.",
          "code": "393.55D1-B",
          "convicted_of_different_charge": false,
          "description": "Air Brake - ABS malfunction lamp defective on truck-tractor manufactured on or after March 1, 1997 and each single unit CMV on or after 1998.",
          "out_of_service": false,
          "time_severity_weight": 4,
          "unit": "1"
        }
      ]
    },
    {
      "hazmat_inspection": false,
      "inspection_date": "2026-03-10",
      "level": 3,
      "placardable_hazmat_vehicle_inspection": false,
      "report_number": "WI2486003052",
      "report_state": "WI",
      "time_weight": 3,
      "vehicles": [
        {
          "license_number": "TS62322",
          "license_state": "WI",
          "unit": 1,
          "unit_type": "Truck Tractor",
          "vin": "1XP5DB9X25N856835"
        },
        {
          "license_number": "869490",
          "license_state": "WI",
          "unit": 2,
          "unit_type": "Semi-Trailer",
          "vin": "1W1MAF1AX2A235615"
        }
      ],
      "violations": [
        {
          "basic": "Unsafe Driving",
          "code": "392.2-SLLS2",
          "convicted_of_different_charge": false,
          "description": "State/Local Laws - Speeding 6-10 miles per hour over the speed limit",
          "out_of_service": false,
          "time_severity_weight": 4,
          "unit": "D"
        }
      ]
    },
    {
      "hazmat_inspection": false,
      "inspection_date": "2026-03-20",
      "level": 3,
      "placardable_hazmat_vehicle_inspection": false,
      "report_number": "WI2551002051",
      "report_state": "WI",
      "time_weight": 3,
      "vehicles": [
        {
          "license_number": "TS60803",
          "license_state": "WI",
          "unit": 1,
          "unit_type": "Truck Tractor",
          "vin": "1XP5DB9X1XN481491"
        },
        {
          "license_number": "838601",
          "license_state": "WI",
          "unit": 2,
          "unit_type": "Semi-Trailer",
          "vin": "5WSAA4320EN045238"
        }
      ],
      "violations": [
        {
          "basic": "Unsafe Driving",
          "code": "392.2-SLLS2",
          "convicted_of_different_charge": false,
          "description": "State/Local Laws - Speeding 6-10 miles per hour over the speed limit",
          "out_of_service": false,
          "time_severity_weight": 4,
          "unit": "D"
        },
        {
          "basic": "Unsafe Driving",
          "code": "392.2-SLLTCD",
          "convicted_of_different_charge": false,
          "description": "State/Local Laws - Failed to obey a traffic control device - Permanent or Temporary - e.g., safety official, signal, sign, light, lane marking, other",
          "out_of_service": false,
          "time_severity_weight": 5,
          "unit": "D"
        }
      ]
    }
  ],
  "observed_at_ms": 1791157546174,
  "offset": 0,
  "page_size": 50,
  "serious_violations": [],
  "snapshot_date": "2026-08-28",
  "source_url": "https://ai.fmcsa.dot.gov/SMS/Carrier/2796384/Download.aspx?BASIC=0&FileType=XML",
  "total_crashes": 0,
  "total_inspections": 4,
  "total_records": 4,
  "total_serious_violations": 0,
  "usdot_number": "2796384"
}
```

### Search carriers

- Capability: `carriers/search_carriers`
- Description: SAFER carrier name search (keywordx.asp): every carrier whose legal or DBA name contains the text, with its USDOT number, city/state and Company Snapshot URL. The site returns at most 500 matches and has no paging; `truncated` is true (and coverage partial) when that cap was hit, so narrow the name. A name that matches nothing is a successful empty result.
- Instructions: You know (part of) a motor carrier's name and need its USDOT number before calling get_carrier_snapshot, get_sms_overview or get_sms_safety_records.
- Cost: 5 credits per call
- Capability file: [Search carriers](https://firecrawl.dev/alexandria/agents/providers/safer-fmcsa-dot-gov/carriers/search_carriers)

Accepted options:
- `name` (string, required): Text contained in the carrier's legal or DBA name (case-insensitive; the site adds its own wildcards). Example: `<name>`

Response schema example:
```json
{
  "count": 3,
  "observed_at_ms": 1791157477597,
  "query": "WERNER ENTERPRISES",
  "results": [
    {
      "city": "MILTON",
      "location": "MILTON, ON",
      "name": "WERNER ENTERPRISES CANADA CORPORATION",
      "snapshot_url": "https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=1054507",
      "state": "ON",
      "usdot_number": "1054507"
    },
    {
      "city": "OMAHA",
      "location": "OMAHA, NE",
      "name": "WERNER ENTERPRISES INC",
      "snapshot_url": "https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=53467",
      "state": "NE",
      "usdot_number": "53467"
    },
    {
      "city": "GONZALES",
      "location": "GONZALES, LA",
      "name": "WERNER ENTERPRISES LLC",
      "snapshot_url": "https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=5965315",
      "state": "LA",
      "usdot_number": "5965315"
    }
  ],
  "source_url": "https://safer.fmcsa.dot.gov/keywordx.asp?searchstring=*WERNER+ENTERPRISES*&SEARCHTYPE=",
  "truncated": false
}
```

### Search sms carriers

- Capability: `carriers/search_sms_carriers`
- Description: SMS carrier search (ai.fmcsa.dot.gov/SMS/Search): carriers whose name contains the query, 50 per page with the total count, each with USDOT number, legal and DBA names, operation, country, service center, state, county, city, passenger/hazmat/new-entrant flags, power units, total inspections and total crashes (24 months). Page 1 is the search form's POST; later pages are the site's SimpleSearchResults fragment, reached with the returned continuation cursor. A query that is a bare USDOT number is resolved by the site to that one carrier. A query that matches nothing is a successful empty result.
- Instructions: You want a listing with fleet size and safety totals per carrier, or more than SAFER's 500-match cap allows, and want to page through it.
- Cost: 5 credits per call
- Capability file: [Search sms carriers](https://firecrawl.dev/alexandria/agents/providers/safer-fmcsa-dot-gov/carriers/search_sms_carriers)

Accepted options:
- `continuation` (string): Opaque cursor from a previous call's meta.page.next_cursor (`<page>:<total>`); omit for page 1. Example: `<page>:<total>`
- `query` (string, required): Carrier name text (contains match) or a USDOT number. Example: `<query>`

Response schema example:
```json
{
  "count": 3,
  "observed_at_ms": 1791157515335,
  "page": 1,
  "page_size": 50,
  "query": "WERNER ENTERPRISES",
  "results": [
    {
      "city": "OMAHA",
      "country": "US",
      "county": "SARPY",
      "dba_name": null,
      "hazmat": false,
      "legal_name": "WERNER ENTERPRISES INC",
      "new_entrant": false,
      "operation": "Interstate Non-HMSP",
      "passenger": false,
      "power_units": 9851,
      "service_center": "MW",
      "sms_url": "https://ai.fmcsa.dot.gov/SMS/Carrier/53467/Overview.aspx",
      "snapshot_url": "https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=53467",
      "state": "NE",
      "total_crashes": 683,
      "total_inspections": 11519,
      "usdot_number": "53467"
    },
    {
      "city": "MILTON",
      "country": "CA",
      "county": "CANADIAN PROVINCE",
      "dba_name": null,
      "hazmat": false,
      "legal_name": "WERNER ENTERPRISES CANADA CORPORATION",
      "new_entrant": false,
      "operation": "Interstate Non-HMSP",
      "passenger": false,
      "power_units": 1,
      "service_center": "EA",
      "sms_url": "https://ai.fmcsa.dot.gov/SMS/Carrier/1054507/Overview.aspx",
      "snapshot_url": "https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=1054507",
      "state": "ON",
      "total_crashes": 0,
      "total_inspections": 0,
      "usdot_number": "1054507"
    },
    {
      "city": "GONZALES",
      "country": "US",
      "county": "ASCENSION",
      "dba_name": null,
      "hazmat": false,
      "legal_name": "WERNER ENTERPRISES LLC",
      "new_entrant": false,
      "operation": "Interstate Non-HMSP",
      "passenger": false,
      "power_units": 1,
      "service_center": "SH",
      "sms_url": "https://ai.fmcsa.dot.gov/SMS/Carrier/5965315/Overview.aspx",
      "snapshot_url": "https://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&query_string=5965315",
      "state": "LA",
      "total_crashes": 0,
      "total_inspections": 0,
      "usdot_number": "5965315"
    }
  ],
  "source_url": "https://ai.fmcsa.dot.gov/SMS/Search/Index.aspx",
  "total_count": 3
}
```

### Suggest sms carrier names

- Capability: `carriers/suggest_sms_carrier_names`
- Description: SMS carrier-name autocomplete (ToolbarHint.aspx): the name prefixes the SMS search box proposes for at least three typed characters, about ten strings.
- Instructions: You have a partial carrier name and want the spellings SMS knows before searching.
- Cost: 5 credits per call
- Capability file: [Suggest sms carrier names](https://firecrawl.dev/alexandria/agents/providers/safer-fmcsa-dot-gov/carriers/suggest_sms_carrier_names)

Accepted options:
- `prefix` (string, required): prefix Example: `<prefix>`

Response schema example:
```json
{
  "count": 10,
  "names": [
    "WERNER EXP",
    "WERNER FARM",
    "WERNER VIGH",
    "WERNERSWOOD",
    "WERNER COACH",
    "WERNER FARMS",
    "WERNER FUELS",
    "WERNER A EGER",
    "WERNER R DIAZ",
    "WERNER A FUCHS"
  ],
  "observed_at_ms": 1791157558434,
  "prefix": "werner",
  "source_url": "https://ai.fmcsa.dot.gov/SMS/Search/ToolbarHint.aspx?term=werner"
}
```
