v1

latestOpenAPI 3.1.02026-07-13255378.3 KB

Advanced filtered carrier search

Filtered search with include/exclude conditions, geo-radius search, sorting, and field projection. No company name required — filter by state, fleet size, cargo type, technology, authority status, revenue, and more.

post/v1/carriers/query

Request body

includeobject

Filter conditions to include. Supports scalar equality, arrays, range objects ({ min, max }), and a location object ({ latitude, longitude, radius_miles }).

excludeobject

Filter conditions to exclude (same shape as include).

fieldsstring[]

Fields to return on each result (e.g. ["dot_number", "legal_name", "power_units"]).

sort_bystring

Sort field: power_units, drivers, date_added, safety_rating, annual_revenue, distance, etc.

sort_order'asc' | 'desc'

limitinteger

pageinteger

Example request

{
  "include": {
    "state": "TX",
    "power_units": {
      "min": 50
    },
    "cargo_type": [
      "Van",
      "Reefer"
    ],
    "operating_authority_status": "Active",
    "location": {
      "latitude": 29.76,
      "longitude": -95.37,
      "radius_miles": 100
    }
  }
}

Response

Paginated, optionally field-projected carrier results

total_resultsinteger

resultsobject[]

Carrier objects projected to the requested fields (or default fields when fields is omitted). When a geo-radius filter is used, each result includes distance_miles.