For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDashboard
GuidesAPI Reference
GuidesAPI Reference
  • Endpoints
      • GETTab counts for the loads list
      • GETGet calls for a load
      • GETGet failed carrier verifications for a load
      • GETGet active escalations for a load
      • GETList webhook endpoints
      • POSTRegister a webhook endpoint
      • GETGet a webhook endpoint
      • DELDelete a webhook endpoint
      • PATCHUpdate a webhook endpoint
      • POSTRotate the signing secret
      • GETList delivery attempts for an endpoint
      • GETList attempts for a logical message
      • POSTReplay a delivery
      • GETList subscribable event types
LogoLogo
SupportDashboard
EndpointsAPI

Get failed carrier verifications for a load

GET
/loads/:load_id/verifications
GET
/api/v1/loads/:load_id/verifications
$curl https://tryenvoy.ai/api/v1/loads/load_id/verifications \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json"
1[
2  {
3    "id": "a3f9c1d2-4b7e-4f3a-9c2d-1e2f3a4b5c6d",
4    "source": "email_outreach",
5    "created_at": "2024-04-20T14:22:00Z",
6    "carrier_id": "car_9f8e7d6c-5b4a-3f2e-1d0c-9b8a7f6e5d4c",
7    "status": "BLOCKED",
8    "reasons": [
9      "Insurance expired",
10      "Missing W9 form"
11    ],
12    "error_stage": "Verification",
13    "error_message": "Carrier insurance expired on 2023-12-31",
14    "carrier": {
15      "id": "car_9f8e7d6c-5b4a-3f2e-1d0c-9b8a7f6e5d4c",
16      "name": "Swift Logistics LLC",
17      "mc_number": "MC123456",
18      "dot_number": "DOT987654",
19      "email": "[email protected]",
20      "phone": "+1-555-123-4567",
21      "dispatcher_name": "Jane Doe",
22      "dispatcher_phone": "+1-555-765-4321",
23      "dispatcher_email": "[email protected]",
24      "is_active": true,
25      "provider": "EnvoyAI",
26      "ingestion_method": "manual_entry",
27      "equipment_types": [
28        "VAN",
29        "REEFER"
30      ],
31      "insurance_expiration": "2023-12-31T23:59:59Z",
32      "w9_on_file": false,
33      "authorized_for_hire": true,
34      "on_time_pickup_pct": 87.5,
35      "on_time_delivery_pct": 92.3,
36      "tracking_compliance_pct": 85,
37      "avg_response_time_min": 45.2,
38      "total_loads_hauled": 124,
39      "is_onboarded": true,
40      "carrier_rep_user_id": "usr_1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
41      "carrier_rep_name": "Michael Smith",
42      "carrier_rep_email": "[email protected]",
43      "is_verified": false,
44      "verified_date": null,
45      "created_at": "2022-11-10T08:15:00Z",
46      "updated_at": "2024-04-19T16:45:00Z"
47    }
48  }
49]
Return every *failed* ``carrier_verifications`` row whose carrier has reached out to this load (via the same outreach hop the Failed Verifications loads-tab filter uses), newest first, hydrated with the carrier. PASSED rows are filtered out — the panel surfaces only compliance failures. **Authentication:** Supports API key and bearer token authentication.
Was this page helpful?
Previous

Get active escalations for a load

Next
Built with

Return every failed carrier_verifications row whose carrier has reached out to this load (via the same outreach hop the Failed Verifications loads-tab filter uses), newest first, hydrated with the carrier. PASSED rows are filtered out — the panel surfaces only compliance failures.

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
carrier_idstringformat: "^car_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
statusenum or null
Allowed values:
reasonslist of strings
error_stagestring or null
error_messagestring or null
carrierobject or null

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