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"
}'
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"
}),
});
const result = await agent.tool('lookup/company-motor-carrier', {
dot_number: '44110'
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"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
}
}
}
Lookups
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.
POST
/
v1
/
tools
/
lookup
/
company-motor-carrier
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"
}'
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"
}),
});
const result = await agent.tool('lookup/company-motor-carrier', {
dot_number: '44110'
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"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
}
}
}
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 thepayment-signature header.
Request Body
string
The carrier’s US Department of Transportation number, 1 to 8 digits, for example 44110. dot_number must be 1 to 8 digits.
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.
Response (200 OK)
Top-level envelope:success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status:
completedstring
Always
company_motor_carrierobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
US Department of Transportation.string
public when the data comes from a public body, commercial otherwisestring
When the lookup was made, as an ISO 8601 UTC time
string
When the source says the fact was last updated, or
null when the source gives no dateResult
Nested underdata.result.
integer
How many carriers were returned, at most 5.
object[]
The matching carriers; empty when none matches.
string
The US Department of Transportation number.
null when the source gives no value.string
The motor carrier (MC) number, or null when the carrier has none.
string
The carrier’s legal name.
null when the source gives no value.string
The name it trades under, or null when it gives none.
string
active, inactive or pending.
null when the source gives no value.string
The legal form, for example CORPORATION.
null when the source gives no value.object
The physical address as registered.
string
Street.
null when the source gives no value.string
City.
null when the source gives no value.string
Two-letter state code.
null when the source gives no value.string
Postal code.
null when the source gives no value.string
Country.
null when the source gives no value.string
The telephone number as registered.
null when the source gives no value.string
interstate, intrastate hazardous material or intrastate non-hazardous material.
null when the source gives no value.string[]
The kinds of operation it registered, for example authorized for hire.
string[]
What it says it carries, for example general freight.
number
Number of power units (trucks, tractors, buses).
null when the source gives no value.number
Number of drivers.
null when the source gives no value.number
Number of drivers with a commercial driver’s licence.
null when the source gives no value.number
Miles driven in
mileage_year, as the carrier reported them. null when the source gives no value.number
The year of
annual_mileage. null when the source gives no value.boolean
Whether it carries hazardous materials, or null when the source gives no answer.
string
satisfactory, conditional or unsatisfactory; null when it has never been rated.
string
Date of the safety rating, YYYY-MM-DD.
null when the source gives no value.string
Date of the carrier’s latest safety review, YYYY-MM-DD.
null when the source gives no value.string
Date the carrier last updated its registration, YYYY-MM-DD.
null when the source gives no value.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"
}'
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"
}),
});
const result = await agent.tool('lookup/company-motor-carrier', {
dot_number: '44110'
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"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
}
}
}
Price: $0.005 per lookup. See Pricing for every tool.
Notes
- Results return inline. The finished job stays available at
/v1/requests/{request_id}