curl "https://api.dotlookup.dev/v1/carriers/search?q=swift&state=TX&fleet_min=10"
import requests
resp = requests.get("https://api.dotlookup.dev/v1/carriers/search", params={
"q": "swift",
"state": "TX",
"fleet_min": 10,
})
results = resp.json()
const params = new URLSearchParams({ q: "swift", state: "TX", fleet_min: "10" });
const resp = await fetch(`https://api.dotlookup.dev/v1/carriers/search?${params}`);
const results = await resp.json();
{
"data": [
{
"dot_number": "2233855",
"mc_number": "747866",
"legal_name": "SWIFT TRANSPORTATION CO",
"dba_name": "",
"city": "Dallas",
"state": "TX",
"status": "ACTIVE",
"entity_type": "CARRIER",
"power_units": 45,
"drivers": 52,
"vehicle_oos_rate": 18.3,
"vehicle_oos_national": 20.72,
"driver_oos_rate": 5.2,
"driver_oos_national": 5.51,
"insurance_bipd": 1000000,
"insurance_cargo": 250000,
"risk_score": 82,
"risk_grade": "B",
"risk_tier": "Good",
"lat": 32.7767,
"lon": -96.797
}
],
"pagination": {
"page": 1,
"per_page": 25,
"total": 1,
"total_pages": 1
}
}
Carriers
Search Carriers
Paginated carrier search with text, filters, and geo/radius support
GET
/
v1
/
carriers
/
search
curl "https://api.dotlookup.dev/v1/carriers/search?q=swift&state=TX&fleet_min=10"
import requests
resp = requests.get("https://api.dotlookup.dev/v1/carriers/search", params={
"q": "swift",
"state": "TX",
"fleet_min": 10,
})
results = resp.json()
const params = new URLSearchParams({ q: "swift", state: "TX", fleet_min: "10" });
const resp = await fetch(`https://api.dotlookup.dev/v1/carriers/search?${params}`);
const results = await resp.json();
{
"data": [
{
"dot_number": "2233855",
"mc_number": "747866",
"legal_name": "SWIFT TRANSPORTATION CO",
"dba_name": "",
"city": "Dallas",
"state": "TX",
"status": "ACTIVE",
"entity_type": "CARRIER",
"power_units": 45,
"drivers": 52,
"vehicle_oos_rate": 18.3,
"vehicle_oos_national": 20.72,
"driver_oos_rate": 5.2,
"driver_oos_national": 5.51,
"insurance_bipd": 1000000,
"insurance_cargo": 250000,
"risk_score": 82,
"risk_grade": "B",
"risk_tier": "Good",
"lat": 32.7767,
"lon": -96.797
}
],
"pagination": {
"page": 1,
"per_page": 25,
"total": 1,
"total_pages": 1
}
}
Paginated search with text, filters, and optional geo/radius support.
When using geo search (
lat/lon), each result includes a distance_miles field with the distance from the search point.Every result carries its risk score. Each row includes
risk_score, risk_grade, and risk_tier, so you can rank or filter a page of results without a follow-up Get Carrier call per row.All three are null when the carrier has no computed score. risk_score of 0 is a real score — the worst one — so test for null explicitly rather than for falsiness.The full component breakdown and risk flags stay on the carrier profile. Use search to narrow, then fetch the profile for the few carriers you care about.Geo resolution is state-level. Every carrier in a state shares the same geocoded point — the centroid of that state. As a result:
- A
radiussmaller than the diameter of a state will return very few or zero results. - Practical floor: ~200 miles to reliably hit carriers in neighboring states’ centroids.
- Use
state=XXfor tighter location filtering at the state level, orcity=...for city-level filtering by name (string match on the carrier’s physical address city).
Query Parameters
string
Text search (matches legal name and DBA name)
string
Filter by MC number. To resolve many MC numbers at once, use Bulk Lookup by MC instead of looping this endpoint.
string
Filter by city
string
Filter by state (2-letter code)
string
default:"ACTIVE"
Filter by carrier status. Use
ALL to include inactive carriersstring
Filter by cargo type
string
Filter by entity type (e.g.
CARRIER, BROKER, FREIGHT FORWARDER, SHIPPER)string
Filter by company officer name (matches either of the two officer slots)
string
Filter by phone number
string
Filter by email address
integer
Minimum power units
integer
Maximum power units
number
Latitude for geo search (requires
lon)number
Longitude for geo search (requires
lat)integer
default:"50"
Search radius in miles (max: 200)
integer
Minimum months of active authority (filters by common authority date)
string
Sort field and direction. Options:
name, name_asc, name_desc, dot, dot_asc, dot_desc, fleet_size, fleet_size_asc, fleet_size_desc, distance, distance_asc, distance_desc (distance options require geo search)integer
default:"1"
Page number
integer
default:"25"
Results per page (max: 100)
curl "https://api.dotlookup.dev/v1/carriers/search?q=swift&state=TX&fleet_min=10"
import requests
resp = requests.get("https://api.dotlookup.dev/v1/carriers/search", params={
"q": "swift",
"state": "TX",
"fleet_min": 10,
})
results = resp.json()
const params = new URLSearchParams({ q: "swift", state: "TX", fleet_min: "10" });
const resp = await fetch(`https://api.dotlookup.dev/v1/carriers/search?${params}`);
const results = await resp.json();
{
"data": [
{
"dot_number": "2233855",
"mc_number": "747866",
"legal_name": "SWIFT TRANSPORTATION CO",
"dba_name": "",
"city": "Dallas",
"state": "TX",
"status": "ACTIVE",
"entity_type": "CARRIER",
"power_units": 45,
"drivers": 52,
"vehicle_oos_rate": 18.3,
"vehicle_oos_national": 20.72,
"driver_oos_rate": 5.2,
"driver_oos_national": 5.51,
"insurance_bipd": 1000000,
"insurance_cargo": 250000,
"risk_score": 82,
"risk_grade": "B",
"risk_tier": "Good",
"lat": 32.7767,
"lon": -96.797
}
],
"pagination": {
"page": 1,
"per_page": 25,
"total": 1,
"total_pages": 1
}
}