# OneShot Agent API – Company Motor Carrier Lookup

> OneShot Agent API – Company Motor Carrier Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Looks up a US motor carrier's FMCSA registration details by MC number or DOT number, returning safety ratings, fleet size, cargo types, and operational status.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/company-motor-carrier?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-company-motor-carrier-lookup-42d47bac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0fAx4_ypcWjdVB82CSS3k

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 oneshot-agent-api-company-motor-carrier-lookup-42d47bac -d '<json body>'
```

Example prompt: Can you look up the FMCSA registration details for motor carrier MC-1515 — I want to see their safety rating, fleet size, cargo types, and whether they're still active?

## When to prefer this

Use this endpoint when you need structured, authoritative FMCSA regulatory data for a US motor carrier — safety ratings, fleet size, cargo authorizations, and contact info — identified by MC or DOT number. Prefer this over generic web search when you need machine-readable, structured fields rather than unstructured text, and when you want to pay per-call with no API key setup via x402/USDC.

## Known failure modes

- MC or DOT number not found in FMCSA database — returns total:0 and empty carriers array
- Malformed MC/DOT number format — request rejected with validation error
- Carrier exists but has no safety rating yet (new or unrated carrier)
- Payment failure if USDC balance insufficient on Base
- Network timeout if FMCSA upstream is slow

## How this service works

Look up a US motor carrier by DOT or MC number: who it is, whether it is active, fleet size, cargo and safety rating.

## Output

Returns a carriers array with full FMCSA profile per carrier: legal name, DBA name, MC and DOT numbers, status (active/inactive), address, phone, entity form (e.g. CORPORATION), operating classes, cargo types, number of drivers and CDL drivers, power units, annual mileage and mileage year, safety rating and rating date, last review date, hazardous materials flag, and registration updated date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mc_number": {
   "type": "string",
   "description": "The carrier's motor carrier (MC) number, for example MC-1515. mc_number must be 1 to 8 digits, with an optional MC or MC- in front."
  },
  "dot_number": {
   "type": "string",
   "description": "The carrier's US Department of Transportation number, for example 44110. dot_number must be 1 to 8 digits."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 1,
  "carriers": [
   {
    "cargo": [
     "general freight",
     "passengers",
     "package express"
    ],
    "phone": "2147776005",
    "status": "active",
    "address": {
     "city": "DALLAS",
     "state": "TX",
     "street": "9773 HARRY HINES BLVD",
     "country": "US",
     "postal_code": "75220-5441"
    },
    "classes": [
     "private passenger, business",
     "private passenger, non-business",
     "authorized for hire"
    ],
    "drivers": 905,
    "dba_name": "BOLT BUS",
    "mc_number": "1515",
    "operation": "interstate",
    "dot_number": "44110",
    "legal_name": "GREYHOUND LINES INC",
    "cdl_drivers": 905,
    "entity_form": "CORPORATION",
    "power_units": 683,
    "mileage_year": 2025,
    "safety_rating": "satisfactory",
    "annual_mileage": 66149781,
    "last_review_date": "2026-07-03",
    "safety_rating_date": "2026-07-08",
    "hazardous_materials": false,
    "registration_updated_on": "2026-04-28"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-company-motor-carrier-lookup-42d47bac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)
