Skip to navigation

Get failed carrier verifications for a load

Return every failed carrier_verifications row recorded against this load, newest first, hydrated with the carrier. A verification names a load when the check was run for one — an outbound outreach to a carrier about this load, or a carrier who called in about it — so a carrier’s failures on other loads are not returned here. PASSED rows are filtered out, and so are drops such as a compliance provider being unreachable, which is not a statement about the carrier.

Authentication: Supports API key and bearer token authentication.

Authentication

AuthorizationBearer

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

Path parameters

load_idstringRequiredformat: "uuid"

Headers

X-Organization-IDstring or nullOptional

Response

Successful Response
idstringformat: "uuid"
sourceenum
created_atdatetime

When the check happened (a call’s blocks carry the moment of the block)

updated_atdatetime

When the check was recorded; the verification feed orders and pages by this

carrier_idstring or nullOptionalformat: "^car_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
phone_call_idstring or nullOptionalformat: "^call_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
statusenum or nullOptional
Allowed values:
providerstring or nullOptional

Compliance provider that ran this check (Highway, MyCarrierPackets). Null when the gate never reached a provider — see drop_reason.

reasonslist of stringsOptional
bypassed_reasonslist of objectsOptional
error_stagestring or nullOptional
error_messagestring or nullOptional
drop_reasonenum or nullOptional
restriction_reasonenum or nullOptional

Set when the organization’s own operational restriction stopped the interaction rather than a compliance verdict, e.g. tms_carrier_inactive for a carrier its TMS marks do-not-load. status is null on these rows; drop_reason is null when the carrier was sent a notice.

Allowed values:
subject_identifierstring or nullOptional

The MC, DOT or sender address checked, when no carrier record exists (carrier_id is null)

subject_identifier_kindstring or nullOptional

What subject_identifier holds: mc, dot, email or phone

subject_namestring or nullOptional
The name given, when no carrier record exists
carrierobject or nullOptional

v1 carrier response - wraps domain CarrierModel with prefixed IDs.

Errors

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