# 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-11).

Queries FMCSA data to vet trucking carriers by authority, insurance, out-of-service status, and safety ratings before tendering a load

## Facts

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

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-58d27040
```

Example prompt: Pull me up to 25 newly registered for-hire interstate carriers in Texas from the last 14 days that handle reefer cargo — I need to vet their FMCSA authority, insurance, and out-of-service status before I tender a load.

## When to prefer this

Choose this endpoint when you need to programmatically vet multiple trucking carriers against FMCSA data before tendering freight — especially useful for compliance automation, carrier onboarding workflows, or spot market vetting where you need authority, insurance, and OOS data for up to 25 carriers per call without manual FMCSA portal lookups.

## Known failure modes

- No carriers found matching the specified filters — returns empty result set
- Invalid state code returns a validation error
- days parameter out of range (must be 1-90) returns an error
- limit parameter out of range (must be 1-200) returns an error
- FMCSA data temporarily unavailable causing upstream timeout
- Payment failure due to insufficient USDC balance (x402 protocol)

## 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 list of up to 200 trucking carrier records sourced from FMCSA data, including each carrier's operating authority status, insurance validity, out-of-service (OOS) flags, and safety information, filterable by state, cargo type, hazmat authorization, for-hire status, and interstate operating authority.

## 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": {
      "days": {
       "type": "integer",
       "default": 7,
       "description": "Look-back window in days (1-90)"
      },
      "cargo": {
       "type": "string",
       "description": "Cargo class, e.g. general, reefer, household, vehicles, livestock, chemicals"
      },
      "limit": {
       "type": "integer",
       "default": 50,
       "description": "Rows to return (1-200)"
      },
      "state": {
       "type": "string",
       "description": "2-letter state code, e.g. TX"
      },
      "hazmat": {
       "type": "boolean",
       "default": false,
       "description": "Only hazmat carriers"
      },
      "forHire": {
       "type": "boolean",
       "default": false,
       "description": "Only authorized-for-hire carriers"
      },
      "interstate": {
       "type": "boolean",
       "default": false,
       "description": "Only interstate 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-58d27040/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)