# FMCSA Motor Carrier Name Search

> FMCSA Motor Carrier Name Search is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-15).

Search US motor carriers by name in the FMCSA Company Census, returning ranked candidates with USDOT number, MC docket, legal name, state, carrier status, authority status, and operation type.

## Facts

- Endpoint: GET https://payai.agentstools.dev/freight/lookup
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fmcsa-motor-carrier-name-search-93baa040
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XGAJyyAY86i1Qj67v9OcX

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-motor-carrier-name-search-93baa040
```

Example prompt: Can you look up 'Werner Enterprises' in the FMCSA carrier database and get me their USDOT number, MC docket, authority status, and what state they operate from? Return the top 3 matches.

## When to prefer this

Use this endpoint as a cheap first step when you have a carrier's name but need their USDOT number, MC docket, or regulatory status before making downstream freight or carrier API calls. Prefer this over broader company enrichment endpoints when the entity is specifically a US motor carrier regulated by FMCSA. The state filter helps narrow results when the carrier name is common.

## Known failure modes

- No carriers found for the given name — returns empty candidates list
- Name too generic — returns many low-relevance candidates requiring manual disambiguation
- State filter typo or invalid 2-letter code — may return error or unfiltered results
- FMCSA source data unavailable or stale — may return outdated status information
- Limit parameter out of range (not 1–15) — returns validation error

## How this service works

Search US motor carriers by name in the FMCSA Company Census and get ranked candidates, each with its USDOT number, MC docket, legal name, state, decoded carrier status, authority status and operation. Cheap first step before freight/carrier.

## Output

A ranked list of up to 15 motor carrier candidates matching the search name, each containing USDOT number, MC docket number, legal business name, physical state, decoded carrier status, authority status, and operation type — useful as a first-pass identification step before deeper freight or carrier verification.

## 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": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "Carrier name to search for"
      },
      "limit": {
       "type": "integer",
       "maximum": 15,
       "minimum": 1,
       "description": "Max candidates to return, default 5"
      },
      "state": {
       "type": "string",
       "description": "Optional 2-letter physical state filter"
      }
     }
    }
   },
   "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-motor-carrier-name-search-93baa040/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)
