Skip to main content
GET
/
v1
/
carriers
/
search
curl "https://api.dotlookup.dev/v1/carriers/search?q=swift&state=TX&fleet_min=10"

{
  "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,
      "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.
Geo resolution is state-level. Every carrier in a state shares the same geocoded point — the centroid of that state. As a result:
  • A radius smaller 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=XX for tighter location filtering at the state level, or city=... for city-level filtering by name (string match on the carrier’s physical address city).
This is a limitation of the daily ETL’s geocoding step, not a query bug. Real per-carrier geocoding is on the roadmap.

​
Query Parameters

​
q
string
Text search (matches legal name and DBA name)
​
mc_number
string
Filter by MC number. To resolve many MC numbers at once, use Bulk Lookup by MC instead of looping this endpoint.
​
city
string
Filter by city
​
state
string
Filter by state (2-letter code)
​
status
string
default:"ACTIVE"
Filter by carrier status. Use ALL to include inactive carriers
​
cargo
string
Filter by cargo type
​
entity_type
string
Filter by entity type (e.g. CARRIER, BROKER, FREIGHT FORWARDER, SHIPPER)
​
officer
string
Filter by company officer name (matches either of the two officer slots)
​
phone
string
Filter by phone number
​
email
string
Filter by email address
​
fleet_min
integer
Minimum power units
​
fleet_max
integer
Maximum power units
​
lat
number
Latitude for geo search (requires lon)
​
lon
number
Longitude for geo search (requires lat)
​
radius
integer
default:"50"
Search radius in miles (max: 200)
​
authority_months_min
integer
Minimum months of active authority (filters by common authority date)
​
sort
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)
​
page
integer
default:"1"
Page number
​
per_page
integer
default:"25"
Results per page (max: 100)
curl "https://api.dotlookup.dev/v1/carriers/search?q=swift&state=TX&fleet_min=10"

{
  "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,
      "lat": 32.7767,
      "lon": -96.797
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 1,
    "total_pages": 1
  }
}