> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Motor Carrier Record

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

Given a US Department of Transportation (DOT) number or a motor carrier (MC) number, return the carrier's registration record from the US Department of Transportation: legal and trading name, whether it is active, legal form, physical address, telephone number, kind of operation, the classes of operation and the cargo it registered, its power units and drivers, its reported annual mileage, whether it carries hazardous materials, its safety rating with the date, its latest review date and the date it last updated its registration. Give exactly one of `dot_number` and `mc_number`. A DOT number finds one carrier; an MC number can find more than one, so check `status`. Dates are YYYY-MM-DD and a value the source does not give is null. `total` is the number of carriers returned, at most 5; no match is a completed result with `total` 0 and an empty list. It does not cover operating authority, insurance on file, out-of-service rates or crash counts.

## Authentication

Requires x402 payment in the `payment-signature` header.

## Request Body

<ParamField body="dot_number" type="string">
  The carrier's US Department of Transportation number, 1 to 8 digits, for example 44110. dot\_number must be 1 to 8 digits.
</ParamField>

<ParamField body="mc_number" type="string">
  The carrier's motor carrier (MC) number, 1 to 8 digits, with an optional MC or MC- in front, for example MC-1515. mc\_number must be 1 to 8 digits, with an optional MC or MC- in front.
</ParamField>

<Snippet file="audit-context-params.mdx" />

## Response (200 OK)

Top-level envelope: `success` (boolean) and `data` (object). All fields below are nested under `data`.

<ResponseField name="data.request_id" type="string">
  Durable job ID for audit and lookup
</ResponseField>

<ResponseField name="data.status" type="string">
  Job status: `completed`
</ResponseField>

<ResponseField name="data.tool" type="string">
  Always `company_motor_carrier`
</ResponseField>

<ResponseField name="data.result" type="object">
  The answer, described under Result below
</ResponseField>

<ResponseField name="data.evidence" type="object">
  Where the answer came from and when
</ResponseField>

<ResponseField name="data.evidence.source" type="string">
  The public body the data comes from. Always `US Department of Transportation`.
</ResponseField>

<ResponseField name="data.evidence.source_kind" type="string">
  `public` when the data comes from a public body, `commercial` otherwise
</ResponseField>

<ResponseField name="data.evidence.retrieved_at" type="string">
  When the lookup was made, as an ISO 8601 UTC time
</ResponseField>

<ResponseField name="data.evidence.as_of" type="string">
  When the source says the fact was last updated, or `null` when the source gives no date
</ResponseField>

## Result

Nested under `data.result`.

<ResponseField name="data.result.total" type="integer">
  How many carriers were returned, at most 5.
</ResponseField>

<ResponseField name="data.result.carriers" type="object[]">
  The matching carriers; empty when none matches.
</ResponseField>

<ResponseField name="data.result.carriers[].dot_number" type="string">
  The US Department of Transportation number. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].mc_number" type="string">
  The motor carrier (MC) number, or null when the carrier has none.
</ResponseField>

<ResponseField name="data.result.carriers[].legal_name" type="string">
  The carrier's legal name. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].dba_name" type="string">
  The name it trades under, or null when it gives none.
</ResponseField>

<ResponseField name="data.result.carriers[].status" type="string">
  active, inactive or pending. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].entity_form" type="string">
  The legal form, for example CORPORATION. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].address" type="object">
  The physical address as registered.
</ResponseField>

<ResponseField name="data.result.carriers[].address.street" type="string">
  Street. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].address.city" type="string">
  City. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].address.state" type="string">
  Two-letter state code. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].address.postal_code" type="string">
  Postal code. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].address.country" type="string">
  Country. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].phone" type="string">
  The telephone number as registered. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].operation" type="string">
  interstate, intrastate hazardous material or intrastate non-hazardous material. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].classes" type="string[]">
  The kinds of operation it registered, for example authorized for hire.
</ResponseField>

<ResponseField name="data.result.carriers[].cargo" type="string[]">
  What it says it carries, for example general freight.
</ResponseField>

<ResponseField name="data.result.carriers[].power_units" type="number">
  Number of power units (trucks, tractors, buses). `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].drivers" type="number">
  Number of drivers. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].cdl_drivers" type="number">
  Number of drivers with a commercial driver's licence. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].annual_mileage" type="number">
  Miles driven in `mileage_year`, as the carrier reported them. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].mileage_year" type="number">
  The year of `annual_mileage`. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].hazardous_materials" type="boolean">
  Whether it carries hazardous materials, or null when the source gives no answer.
</ResponseField>

<ResponseField name="data.result.carriers[].safety_rating" type="string">
  satisfactory, conditional or unsatisfactory; null when it has never been rated.
</ResponseField>

<ResponseField name="data.result.carriers[].safety_rating_date" type="string">
  Date of the safety rating, YYYY-MM-DD. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].last_review_date" type="string">
  Date of the carrier's latest safety review, YYYY-MM-DD. `null` when the source gives no value.
</ResponseField>

<ResponseField name="data.result.carriers[].registration_updated_on" type="string">
  Date the carrier last updated its registration, YYYY-MM-DD. `null` when the source gives no value.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-motor-carrier \
    -H "Content-Type: application/json" \
    -H "payment-signature: <base64 x402 payment>" \
    -d '{
      "dot_number": "44110"
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-motor-carrier", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "payment-signature": paymentProof,
    },
    body: JSON.stringify({
      "dot_number": "44110"
    }),
  });
  ```

  ```typescript SDK theme={null}
  const result = await agent.tool('lookup/company-motor-carrier', {
    dot_number: '44110'
  });
  console.log(result.data.result);
  console.log(result.data.evidence);
  ```
</RequestExample>

<ResponseExample>
  ```json Response (200) theme={null}
  {
    "success": true,
    "data": {
      "request_id": "uuid",
      "receipt_id": "rcpt_...",
      "status": "completed",
      "tool": "company_motor_carrier",
      "result": {
        "total": 1,
        "carriers": [
          {
            "dot_number": "44110",
            "mc_number": "1515",
            "legal_name": "GREYHOUND LINES INC",
            "dba_name": "BOLT BUS",
            "status": "active",
            "entity_form": "CORPORATION",
            "address": {
              "street": "9773 HARRY HINES BLVD",
              "city": "DALLAS",
              "state": "TX",
              "postal_code": "75220-5441",
              "country": "US"
            },
            "phone": "2147776005",
            "operation": "interstate",
            "classes": [
              "private passenger, business",
              "private passenger, non-business",
              "authorized for hire"
            ],
            "cargo": [
              "general freight",
              "passengers",
              "package express"
            ],
            "power_units": 683,
            "drivers": 905,
            "cdl_drivers": 905,
            "annual_mileage": 66149781,
            "mileage_year": 2025,
            "hazardous_materials": false,
            "safety_rating": "satisfactory",
            "safety_rating_date": "2026-07-08",
            "last_review_date": "2026-07-03",
            "registration_updated_on": "2026-04-28"
          }
        ]
      },
      "evidence": {
        "source": "US Department of Transportation",
        "source_kind": "public",
        "retrieved_at": "2026-10-13T12:00:00.000Z",
        "as_of": null
      }
    }
  }
  ```
</ResponseExample>

<Info>Price: \$0.005 per lookup. See [Pricing](/pricing) for every tool.</Info>

## Notes

* Results return inline. The finished job stays available at `/v1/requests/{request_id}`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.