DOT Number Lookup
Operating authority, insurance, fleet size and safety rating from a USDOT or MC number.
curl -X POST https://api.1lookup.dev/v1/dot-number-lookup \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"dot_number":"1234567"}'{
"success": true,
"data": {
"dot_number": "1234567",
"mc_number": "MC-123456",
"legal_name": "NORTHWIND LOGISTICS INC",
"dba_name": "Northwind Freight",
"entity_type": "carrier",
"operating_status": "authorized",
"authority": {
"types": [
"common"
],
"status": "active",
"granted_date": "2014-06-02"
},
"insurance": {
"bipd_required": 750000,
"bipd_on_file": 1000000,
"cargo_on_file": true
},
"fleet": {
"power_units": 48,
"drivers": 53,
"reported_date": "2025-09-30"
},
"safety": {
"rating": "satisfactory",
"rating_date": "2022-03-17",
"out_of_service": {
"vehicle_pct": 14.3,
"driver_pct": 2.9,
"vehicle_inspections": 42,
"driver_inspections": 69
}
},
"address": {
"street": "1200 Example Ave",
"city": "Austin",
"state": "TX",
"zip": "78701"
},
"phone": "+15125550164"
},
"meta": {
"credits_used": 10,
"credits_remaining": 999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}
}Authorization
Authorizationstring<bearer>requiredYour API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.
Body
Send the fields as a JSON object with Content-Type: application/json.
dot_numberstringrequiredUSDOT or MC number. Example: 1234567
freshbooleanSkip the 7-day cache and run a new lookup. Charged as a normal lookup.
referencestringYour own identifier, echoed back in meta and shown in lookup history.
Response
A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.
successbooleantrue when the lookup ran.
data.legal_namestringThe carrier's registered legal name, returned alongside any DBA name.
data.operating_statusstringWhether FMCSA shows the carrier as authorized, not authorized or out of service.
data.authority.typesarrayThe operating authority held: common, contract or broker.
data.insurance.bipd_on_filenumberBodily injury and property damage coverage on file with FMCSA, in US dollars.
data.fleet.power_unitsnumberThe number of trucks and tractors the carrier reported.
data.fleet.driversnumberThe number of drivers the carrier reported.
data.safety.ratingstringsatisfactory, conditional, unsatisfactory or not_rated.
data.safety.out_of_serviceobjectVehicle and driver out-of-service percentages, with the inspection counts behind them.
meta.credits_usednumberCredits charged for this call.
meta.credits_remainingnumberYour balance after the call.
meta.cachedbooleantrue when the result came from the 7-day cache.
meta.request_idstringQuote this when you contact support.
Errors
A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.
| HTTP | Code | Meaning |
|---|---|---|
| 401 | unauthorized | The key is missing, malformed or revoked. |
| 402 | insufficient_credits | Your credits are used up and pay as you go is off or at its limit. |
| 422 | invalid_input | A field is missing or malformed. The field property names it. |
| 429 | rate_limited | Too many requests for this key. Wait for the Retry-After interval. |
| 500 | internal_error | Something failed on our side. Safe to retry. |
| 503 | source_unavailable | An upstream source did not answer in time. Safe to retry. |
Billing
10 credits. Charged when the lookup runs and returns a result. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge.
Product overview and use cases