# Haulroll FMCSA Carrier Vetting API

> Haulroll FMCSA Carrier Vetting API is a paid API for AI agents from haulroll-api.cybermax-tools.workers.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-12).

Looks up FMCSA regulatory data for up to 25 trucking carriers at once, returning authority status, insurance, out-of-service rates, and safety scores before load tender.

## Facts

- Endpoint: GET https://haulroll-api.cybermax-tools.workers.dev/x402/api/carrier?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/haulroll-fmcsa-carrier-vetting-api-18e9f9a1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4T4FX27M10ZCjVwdrMg4a

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 haulroll-fmcsa-carrier-vetting-api-18e9f9a1
```

Example prompt: Can you vet these carriers for me before I tender the load — DOT numbers 1234567, 9876543, and MC number 456789 — I need to see their authority status, insurance, and safety scores.

## When to prefer this

Choose this endpoint when you need to vet trucking carriers against official FMCSA data before tendering freight loads, especially when screening multiple carriers in bulk (up to 25 per call). It is the right choice for freight brokers, shippers, and logistics platforms that need real-time authority, insurance, and safety compliance checks without building their own FMCSA integration. Prefer it over manual FMCSA portal lookups or generic business verification APIs when the carrier identifiers are USDOT or MC/MX/FF docket numbers specifically.

## Known failure modes

- Invalid or non-existent DOT/MC/MX/FF number returns no data or an error for that carrier
- More than 25 carrier identifiers submitted in one call may result in rejection or truncation
- FMCSA data unavailable or stale due to upstream outage returns incomplete records
- Malformed query parameter format causes a 400 bad request
- Payment not processed or insufficient USDC balance results in 402 Payment Required

## How this service works

Vet a trucking carrier before you tender the load. FMCSA carrier vetting API + MCP: authority, insurance, OOS, safety, 25 carriers per call Try it free in one click, no sign-up.

## Output

Returns a structured JSON response for each queried carrier containing FMCSA regulatory data including operating authority status (active/inactive/revoked), insurance on file, out-of-service (OOS) inspection rates, safety rating, and carrier identification details. Up to 25 carriers can be returned in a single call.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "dot": {
       "type": "string",
       "description": "USDOT numbers and/or MC/MX/FF docket numbers, up to 25, separated by commas or spaces (or POST {\"carriers\": [...]})"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/haulroll-fmcsa-carrier-vetting-api-18e9f9a1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from haulroll-api.cybermax-tools.workers.dev](https://www.zero.xyz/host/haulroll-api.cybermax-tools.workers.dev/llms.txt)