# FMCSA US Motor Carrier Fitness Vetting

> FMCSA US Motor Carrier Fitness Vetting is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-12).

Returns a fit-to-haul verdict, fitness score (0-100), and per-dimension flags for a US motor carrier based on FMCSA registration data

## Facts

- Endpoint: GET https://payai.agentstools.dev/freight/carrier?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fmcsa-us-motor-carrier-fitness-vetting-88c086db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RWC1LW5DtbZBr58ht_NNa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fmcsa-us-motor-carrier-fitness-vetting-88c086db
```

Example prompt: Can you vet carrier MC number 345678 for me — I need a fitness verdict and score from FMCSA data before I book them for a hazmat haul?

## When to prefer this

Use this endpoint when you need a deterministic, rules-based fitness assessment of a US motor carrier from authoritative FMCSA data, especially before booking freight, onboarding a carrier, or assessing hazmat or household goods transport eligibility. Prefer this over manual FMCSA portal lookups or LLM-based carrier research when you need a structured, scored output with per-dimension flags and no hallucination risk.

## Known failure modes

- Carrier not found in FMCSA database — returns verdict 'not_found'
- Ambiguous carrier name with multiple matches — best match is used, may not be the intended carrier
- Missing required identifier (no dot, mc, or name provided) — likely a 400 error
- FMCSA data may be stale; registration freshness dimension flags this
- Carrier has incomplete FMCSA records — some dimension flags may be absent

## How this service works

Fit-to-haul verdict for a US motor carrier from FMCSA registration data. Give one of dot, mc or name and get a verdict (fit, caution, unfit or not_found), a 0-100 fit score, per-dimension flags, reasons and weighted signals across authority status, operation, hazmat, safety rating, history, registration freshness, address and fleet. Deterministic, no LLM. Carrier vetting indicators, not legal or compliance advice.

## Output

A JSON object containing: a verdict string (fit, caution, unfit, or not_found), a numeric fit score from 0-100, per-dimension flags and reasons across dimensions including authority status, operation type, hazmat capability, safety rating, history, registration freshness, address quality, and fleet size, plus weighted signals used to compute the score.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "mc": {
       "type": "string",
       "description": "MC, MX or FF docket number (digits only, no prefix)"
      },
      "dot": {
       "type": "string",
       "description": "USDOT number of the carrier"
      },
      "name": {
       "type": "string",
       "description": "Carrier legal name (best match is used)"
      },
      "state": {
       "type": "string",
       "description": "Optional 2-letter state hint to disambiguate a name"
      },
      "haul_type": {
       "enum": [
        "general",
        "hazmat",
        "household_goods",
        "passengers",
        "oil"
       ],
       "type": "string",
       "description": "Type of haul to check fitness for, default general"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fmcsa-us-motor-carrier-fitness-vetting-88c086db/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)