EndpointsCarriers

List carriers

List carriers with pagination and optional search by name, MC#, or DOT#. Supports two verdict-filter modes that coexist on this endpoint: * **Operational mode** (default) — `verdict` / `verified_date_*` filter on current `Carrier.is_verified` + `verified_date` state. * **Audit-table mode** — when `latest_status` is set (with required `since` + `until`), filter carriers whose **latest** `carrier_verifications` row inside the window matches that status. Mirrors the scorecard Compliance & Risk tile counts exactly. `verdict` / `verified_date_*` are ignored in this mode. **Authentication:** Supports API key and bearer token authentication.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

X-Organization-IDstring or nullOptional

Query parameters

searchstring or nullOptional

Search by name, MC#, DOT#

is_activeboolean or nullOptionalDefaults to true
Filter by active status
verdictstring or nullOptional

Filter by compliance verdict (PASSED | BLOCKED | UNVERIFIED)

verified_date_startdate or nullOptional

Filter carriers verified on/after this date. Mirrors the scorecard’s verdict-breakdown period bucketing on Carrier.verified_date.

verified_date_enddate or nullOptional

Filter carriers verified on/before this date. Mirrors the scorecard’s verdict-breakdown period bucketing on Carrier.verified_date.

latest_statusstring or nullOptional

Audit-table mode switch. Filter carriers whose latest carrier_verifications row in [since, until] has this status (PASSED | BLOCKED | UNVERIFIED). Requires since and until to be set. When this is set, verdict and verified_date_* are ignored.

sincedate or nullOptional

Inclusive lower bound for audit-table mode (carrier_verifications.created_at).

untildate or nullOptional

Inclusive upper bound for audit-table mode (carrier_verifications.created_at).

verification_sourceenum or nullOptional

Optional source filter for audit-table mode (api | extension | truck_list_email | voice_call | chat_tool). Mirrors the scorecard’s source dropdown.

pageintegerOptional>=1Defaults to 1
Page number
page_sizeintegerOptional1-100Defaults to 20
Results per page

Response

Successful Response
datalist of objects
List of items for the current page
paginationobject
Pagination metadata

Errors

401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error
429
Too Many Requests Error