---
title: "Advanced filtered carrier search"
method: POST
path: "/v1/carriers/query"
---

# Advanced filtered carrier search

`POST /v1/carriers/query`

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.

## Request body

- CarrierQueryRequest — Filter body for POST /v1/carriers/query. All fields optional.
  - `include` object — Filter conditions to include. Supports scalar equality, arrays, range objects ({ min, max }), and a location object ({ latitude, longitude, radius_miles }).
  - `exclude` object — Filter conditions to exclude (same shape as include).
  - `fields` string[] — Fields to return on each result (e.g. ["dot_number", "legal_name", "power_units"]).
  - `sort_by` string — Sort field: power_units, drivers, date_added, safety_rating, annual_revenue, distance, etc.
  - `sort_order` 'asc' | 'desc'
  - `limit` integer
  - `page` integer

## Response `200`

Paginated, optionally field-projected carrier results

- CarrierQueryResponse
  - `total_results` integer
  - `results` object[] — 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.
  - `pagination` Pagination
    - `page` integer
    - `limit` integer
    - `total_results` integer
    - `total_pages` integer

## Other responses

- `400` — Invalid parameters
- `401` — Invalid or missing API key
- `429` — Too many requests. Check X-RateLimit-Remaining and Retry-After headers.

---

[API](https://skmtc.net/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api.md) · [All operations](https://skmtc.net/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/runalphaloops/alphaloops-fmcsa-carrier-data-api/versions/dcfdb73e5778/schema)