{ "openapi": "3.0.3", "info": { "title": "CarrierOk API", "version": "v2", "description": "CarrierOk provides FMCSA carrier data via a REST API: carrier profiles, autocomplete, and monitoring watchlists. Authenticate with your API key as a Bearer token — `Authorization: Bearer sk_live_...` (`sk_test_` for sandbox); the `x-api-key` header is also accepted. Base URL: `https://api.carrierok.com`. Get a sandbox key free at https://developers.carrierok.com — first $50 of usage on activation.", "contact": { "email": "support@carrierok.com", "url": "https://developers.carrierok.com" }, "termsOfService": "https://www.carrier-ok.com/api-terms", "license": { "name": "Proprietary" } }, "externalDocs": { "url": "https://developers.carrierok.com/docs", "description": "CarrierOk API documentation — guides, endpoint reference, authentication, and pricing." }, "servers": [ { "url": "https://api.carrierok.com", "description": "Production" } ], "tags": [ { "name": "Profiles", "description": "Carrier profile data — DOT lookups, search by company / EIN / VIN / etc., autocomplete" }, { "name": "Monitoring", "description": "Watchlist management — add/remove DOTs to monitor for changes, list monitored set" } ], "security": [ { "BearerAuth": [] }, { "ApiKeyAuth": [] } ], "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "Alternative to Bearer: pass the same key in the `x-api-key` header." }, "BearerAuth": { "type": "http", "scheme": "bearer", "description": "Preferred. Pass your key as a Bearer token: Authorization: Bearer sk_live_... (sk_test_ for sandbox)." } }, "schemas": { "ErrorResponse": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "string", "description": "Human-readable error message", "example": "Missing required parameter: dot_number" }, "code": { "type": "string", "description": "Machine-readable error code (when available)", "example": "MISSING_PARAM" }, "hint": { "type": "string", "description": "Developer hint for resolution (when available)", "example": "Pass dot_number as a query parameter, e.g. ?dot_number=568253" } } }, "CarrierProfile": { "type": "object", "description": "Full FMCSA carrier profile — 326 typed fields generated from the data dictionary (see /docs/data-dictionary). FMCSA source data is sparse: fields with no value for a carrier are omitted from responses rather than returned as null, so treat every property as optional. additionalProperties stays true for forward compatibility. The /v2/profile example is a real captured response.", "properties": { "dot_number": { "type": "string", "description": "USDOT number — the primary identifier for every motor carrier.", "example": "568253" }, "docket_prefix": { "type": "string", "description": "Docket type prefix (MC, MX, or FF).", "example": "MC" }, "docket_number": { "type": "string", "description": "Numeric portion of the docket.", "example": "277621" }, "docket": { "type": "string", "description": "Full docket string (prefix + number).", "example": "MC277621" }, "doc_id": { "type": "string", "description": "CarrierOk profile ID (DOT-docket). Used as the key for monitoring endpoints.", "example": "568253-MC277621" }, "ein": { "type": "string", "description": "Employer Identification Number (IRS tax ID).", "example": "954485461" }, "legal_name": { "type": "string", "description": "Legal business name as registered with FMCSA.", "example": "HANSEN & ADKINS AUTO TRANSPORT INC" }, "dba_flag": { "type": "boolean", "description": "Whether the legal_name is a DBA (Doing Business As).", "example": false }, "entity_type_desc": { "type": "string", "description": "Entity type: Carrier, Broker, or Freight Forwarder.", "example": "Carrier" }, "carrier_operation_desc": { "type": "string", "description": "Interstate or intrastate operation scope.", "example": "interstate" }, "organization_type_desc": { "type": "string", "description": "Business organization type (Corporation, LLC, etc.).", "example": "CORPORATION" }, "usdot_status": { "type": "string", "description": "Current USDOT registration status.", "example": "Active" }, "icc_dockets": { "type": "string", "description": "Legacy ICC docket numbers associated with this carrier.", "example": "MC277621" }, "added_date": { "type": "string", "description": "Date the carrier was first registered with FMCSA (YYYY-MM-DD).", "example": "1994-07-07" }, "dot_age": { "type": "string", "description": "Days since FMCSA registration. Used to identify new entrants (< 540 days).", "example": "11563" }, "snapshot_date": { "type": "string", "description": "Date of the most recent data snapshot from FMCSA.", "example": "2026-03-04" }, "authority_common": { "type": "string", "description": "Common (for-hire) authority status: Active, Inactive, or None.", "example": "Active" }, "authority_contract": { "type": "string", "description": "Contract authority status.", "example": "Active" }, "authority_broker": { "type": "string", "description": "Broker authority status.", "example": "None" }, "authority_common_pending": { "type": "boolean", "description": "Whether common authority application is pending.", "example": false }, "authority_contract_pending": { "type": "boolean", "description": "Whether contract authority application is pending.", "example": false }, "authority_broker_pending": { "type": "boolean", "description": "Whether broker authority application is pending.", "example": false }, "authority_common_review": { "type": "boolean", "description": "Whether common authority is under FMCSA review.", "example": false }, "authority_contract_review": { "type": "boolean", "description": "Whether contract authority is under FMCSA review.", "example": false }, "authority_broker_review": { "type": "boolean", "description": "Whether broker authority is under FMCSA review.", "example": false }, "authority_common_revocation": { "type": "boolean", "description": "Whether common authority is currently revoked.", "example": false }, "authority_contract_revocation": { "type": "boolean", "description": "Whether contract authority is currently revoked.", "example": false }, "authority_broker_revocation": { "type": "boolean", "description": "Whether broker authority is currently revoked.", "example": false }, "authority_age_common": { "type": "string", "description": "Days since common authority was first granted.", "example": "7937" }, "authority_age_common_active": { "type": "string", "description": "Days common authority has been continuously active.", "example": "7937" }, "authority_age_contract": { "type": "string", "description": "Days since contract authority was first granted.", "example": "11460" }, "authority_age_contract_active": { "type": "string", "description": "Days contract authority has been continuously active.", "example": "11460" }, "authority_start_common": { "type": "string", "description": "Date common authority was first granted (YYYY-MM-DD).", "example": "2004-06-10" }, "authority_start_contract": { "type": "string", "description": "Date contract authority was first granted (YYYY-MM-DD).", "example": "1994-10-18" }, "total_revocations": { "type": "string", "description": "Total number of authority revocations in carrier history.", "example": "2" }, "days_since_last_revocation": { "type": "string", "description": "Days since the most recent authority revocation.", "example": "7954" }, "authority_common_last_revocation_date": { "type": "string", "description": "Date of the most recent common authority revocation.", "example": "2004-05-24" }, "last_revocation_date": { "type": "string", "description": "Date of the most recent revocation of any authority type.", "example": "2004-05-24" }, "indicator_authority": { "type": "boolean", "description": "True if at least one authority type is active.", "example": true }, "authority_history": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Historical authority status changes with dates." }, "insurance_bipd_on_file": { "type": "string", "description": "BIPD liability coverage currently on file (dollars).", "example": "1000000" }, "insurance_bipd_required": { "type": "string", "description": "BIPD coverage required for this carrier's authority type.", "example": "1000000" }, "insurance_cargo_on_file": { "type": "string", "description": "Cargo insurance currently on file (dollars).", "example": "0" }, "insurance_cargo_required": { "type": "string", "description": "Cargo insurance required by FMCSA.", "example": "0" }, "insurance_bond_on_file": { "type": "string", "description": "Surety bond/trust fund currently on file (dollars).", "example": "0" }, "insurance_bond_required": { "type": "string", "description": "Surety bond amount required.", "example": "0" }, "indicator_insurance": { "type": "boolean", "description": "True if all required insurance coverage is on file.", "example": true }, "insurance_history": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Historical insurance policy changes." }, "insurance_cancel_count": { "type": "string", "description": "Total number of insurance policy cancellations.", "example": "26" }, "insurance_last_canceled": { "type": "string", "description": "Date of the most recent insurance cancellation.", "example": "2020-03-11" }, "iss_value": { "type": "string", "description": "Inspection Selection System score (1–100). Higher = higher inspection priority.", "example": "45" }, "iss_recommendation": { "type": "string", "description": "CarrierOk ISS-based recommendation: PASS, REVIEW, or FAIL.", "example": "PASS" }, "iss_recommendation_reason": { "type": "string", "description": "Explanation for the ISS recommendation.", "example": "Sufficient Data - No BASICs Prioritized" }, "risk_score": { "type": "string", "description": "CarrierOk composite risk classification: Low, Medium, High, or Very High.", "example": "Low" }, "risk_score_probability": { "type": "number", "description": "Probability value underlying the risk_score classification (0–1).", "example": 0.217 }, "safety_score": { "type": "string", "description": "CarrierOk safety composite score (0–100).", "example": "100" }, "safety_rating_desc": { "type": "string", "description": "FMCSA safety rating: Satisfactory, Conditional, Unsatisfactory, or Not Rated.", "example": "Satisfactory" }, "safety_rating_date": { "type": "string", "description": "Date the safety rating was assigned.", "example": "2021-12-17" }, "latest_review_type_desc": { "type": "string", "description": "Type of the most recent FMCSA review.", "example": "Compliance Review" }, "latest_review_date": { "type": "string", "description": "Date of the most recent FMCSA review.", "example": "2021-07-29" }, "indicator_carrier_safety": { "type": "boolean", "description": "True when the carrier MEETS safe-carrier criteria: has roadside inspections on record, no active BASIC alerts, not Conditional/Unsatisfactory rated, and out-of-service rates below thresholds. This is a positive signal (true = safe), not a risk flag, and not FMCSA's official High Risk Carrier designation. Null for intrastate carriers.", "example": true }, "basic_measure_controlled_substance": { "oneOf": [ { "type": "string" }, { "type": "number" } ], "description": "Raw BASIC measure for each category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials, crash_indicator.", "example": "0.152" }, "basic_measure_crash_indicator": { "oneOf": [ { "type": "string" }, { "type": "number" } ], "description": "Raw BASIC measure for each category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials, crash_indicator.", "example": "0.152" }, "basic_measure_driver_fitness": { "oneOf": [ { "type": "string" }, { "type": "number" } ], "description": "Raw BASIC measure for each category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials, crash_indicator.", "example": "0.152" }, "basic_measure_hazardous_materials": { "oneOf": [ { "type": "string" }, { "type": "number" } ], "description": "Raw BASIC measure for each category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials, crash_indicator.", "example": "0.152" }, "basic_measure_hours_of_service": { "oneOf": [ { "type": "string" }, { "type": "number" } ], "description": "Raw BASIC measure for each category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials, crash_indicator.", "example": "0.152" }, "basic_measure_unsafe_driving": { "oneOf": [ { "type": "string" }, { "type": "number" } ], "description": "Raw BASIC measure for each category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials, crash_indicator.", "example": "0.152" }, "basic_measure_vehicle_maintence": { "oneOf": [ { "type": "string" }, { "type": "number" } ], "description": "Raw BASIC measure for each category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials, crash_indicator.", "example": "0.152" }, "basic_percentile_crash_indicator": { "type": "number", "description": "BASIC percentile (0–1) relative to peer group. Higher = worse. Available for crash_indicator and hazardous_materials (CarrierOk-computed), plus 5 FMCSA-public categories.", "example": 0.19 }, "basic_alert_controlled_substance": { "type": "boolean", "description": "True if the carrier's percentile exceeds FMCSA's intervention threshold for that BASIC.", "example": false }, "basic_alert_crash_indicator": { "type": "boolean", "description": "True if the carrier's percentile exceeds FMCSA's intervention threshold for that BASIC.", "example": false }, "basic_alert_driver_fitness": { "type": "boolean", "description": "True if the carrier's percentile exceeds FMCSA's intervention threshold for that BASIC.", "example": false }, "basic_alert_hazardous_materials": { "type": "boolean", "description": "True if the carrier's percentile exceeds FMCSA's intervention threshold for that BASIC.", "example": false }, "basic_alert_hours_of_service": { "type": "boolean", "description": "True if the carrier's percentile exceeds FMCSA's intervention threshold for that BASIC.", "example": false }, "basic_alert_unsafe_driving": { "type": "boolean", "description": "True if the carrier's percentile exceeds FMCSA's intervention threshold for that BASIC.", "example": false }, "basic_alert_vehicle_maintence": { "type": "boolean", "description": "True if the carrier's percentile exceeds FMCSA's intervention threshold for that BASIC.", "example": false }, "basic_roadside_alert_controlled_substance": { "type": "boolean", "description": "True if a roadside alert (elevated risk) is active.", "example": false }, "basic_roadside_alert_crash_indicator": { "type": "boolean", "description": "True if a roadside alert (elevated risk) is active.", "example": false }, "basic_roadside_alert_driver_fitness": { "type": "boolean", "description": "True if a roadside alert (elevated risk) is active.", "example": false }, "basic_roadside_alert_hazardous_materials": { "type": "boolean", "description": "True if a roadside alert (elevated risk) is active.", "example": false }, "basic_roadside_alert_hours_of_service": { "type": "boolean", "description": "True if a roadside alert (elevated risk) is active.", "example": false }, "basic_roadside_alert_unsafe_driving": { "type": "boolean", "description": "True if a roadside alert (elevated risk) is active.", "example": false }, "basic_roadside_alert_vehicle_maintence": { "type": "boolean", "description": "True if a roadside alert (elevated risk) is active.", "example": false }, "basic_ac_indicator_controlled_substance": { "type": "boolean", "description": "True if an acute/critical violation indicator exists.", "example": false }, "basic_ac_indicator_driver_fitness": { "type": "boolean", "description": "True if an acute/critical violation indicator exists.", "example": false }, "basic_ac_indicator_hazardous_materials": { "type": "boolean", "description": "True if an acute/critical violation indicator exists.", "example": false }, "basic_ac_indicator_hours_of_service": { "type": "boolean", "description": "True if an acute/critical violation indicator exists.", "example": false }, "basic_ac_indicator_unsafe_driving": { "type": "boolean", "description": "True if an acute/critical violation indicator exists.", "example": false }, "basic_ac_indicator_vehicle_maintence": { "type": "boolean", "description": "True if an acute/critical violation indicator exists.", "example": false }, "intervention_threshold_controlled_substance": { "type": "number", "description": "FMCSA intervention threshold for each category (e.g., 0.65 for Unsafe Driving, 0.80 for Vehicle Maintenance).", "example": 0.65 }, "intervention_threshold_crash_indicator": { "type": "number", "description": "FMCSA intervention threshold for each category (e.g., 0.65 for Unsafe Driving, 0.80 for Vehicle Maintenance).", "example": 0.65 }, "intervention_threshold_driver_fitness": { "type": "number", "description": "FMCSA intervention threshold for each category (e.g., 0.65 for Unsafe Driving, 0.80 for Vehicle Maintenance).", "example": 0.65 }, "intervention_threshold_hazardous_materials": { "type": "number", "description": "FMCSA intervention threshold for each category (e.g., 0.65 for Unsafe Driving, 0.80 for Vehicle Maintenance).", "example": 0.65 }, "intervention_threshold_hours_of_service": { "type": "number", "description": "FMCSA intervention threshold for each category (e.g., 0.65 for Unsafe Driving, 0.80 for Vehicle Maintenance).", "example": 0.65 }, "intervention_threshold_unsafe_driving": { "type": "number", "description": "FMCSA intervention threshold for each category (e.g., 0.65 for Unsafe Driving, 0.80 for Vehicle Maintenance).", "example": 0.65 }, "intervention_threshold_vehicle_maintence": { "type": "number", "description": "FMCSA intervention threshold for each category (e.g., 0.65 for Unsafe Driving, 0.80 for Vehicle Maintenance).", "example": 0.65 }, "basic_history": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Historical BASIC percentile trends over time." }, "violations_total": { "type": "string", "description": "Total violations in each BASIC category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials.", "example": "89" }, "violations_controlled_substance": { "type": "string", "description": "Total violations in each BASIC category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials.", "example": "89" }, "violations_driver_fitness": { "type": "string", "description": "Total violations in each BASIC category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials.", "example": "89" }, "violations_hazardous_materials": { "type": "string", "description": "Total violations in each BASIC category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials.", "example": "89" }, "violations_hours_of_service": { "type": "string", "description": "Total violations in each BASIC category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials.", "example": "89" }, "violations_oos_controlled_substance": { "type": "string", "description": "Violations that resulted in an out-of-service order.", "example": "0" }, "violations_oos_driver_fitness": { "type": "string", "description": "Violations that resulted in an out-of-service order.", "example": "0" }, "violations_oos_hazardous_materials": { "type": "string", "description": "Violations that resulted in an out-of-service order.", "example": "0" }, "violations_oos_hours_of_service": { "type": "string", "description": "Violations that resulted in an out-of-service order.", "example": "0" }, "violations_oos_unsafe_driving": { "type": "string", "description": "Violations that resulted in an out-of-service order.", "example": "0" }, "violations_oos_vehicle_maintence": { "type": "string", "description": "Violations that resulted in an out-of-service order.", "example": "0" }, "violations_severe_controlled_substance": { "type": "string", "description": "Severe violations (higher weight in BASIC calculation).", "example": "26" }, "violations_severe_driver_fitness": { "type": "string", "description": "Severe violations (higher weight in BASIC calculation).", "example": "26" }, "violations_severe_hazardous_materials": { "type": "string", "description": "Severe violations (higher weight in BASIC calculation).", "example": "26" }, "violations_severe_hours_of_service": { "type": "string", "description": "Severe violations (higher weight in BASIC calculation).", "example": "26" }, "violations_severe_unsafe_driving": { "type": "string", "description": "Severe violations (higher weight in BASIC calculation).", "example": "26" }, "violations_severe_vehicle_maintence": { "type": "string", "description": "Severe violations (higher weight in BASIC calculation).", "example": "26" }, "violations_unsafe_driving": { "type": "string", "description": "Total violations in each BASIC category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials.", "example": "89" }, "violations_vehicle_maintence": { "type": "string", "description": "Total violations in each BASIC category. Categories: unsafe_driving, hours_of_service, vehicle_maintence, controlled_substance, driver_fitness, hazardous_materials.", "example": "89" }, "last_violation_date": { "type": "string", "description": "Date of the most recent violation (YYYY-MM-DD).", "example": "2026-02-26" }, "inspections_total": { "type": "string", "description": "Total inspections across all types.", "example": "653" }, "inspections_driver": { "type": "string", "description": "Driver-focused inspections.", "example": "652" }, "inspections_vehicle": { "type": "string", "description": "Vehicle-focused inspections.", "example": "300" }, "inspections_hazmat": { "type": "string", "description": "Hazmat-focused inspections.", "example": "1" }, "inspections_driver_out_of_service": { "type": "string", "description": "Driver inspections resulting in an OOS order.", "example": "6" }, "inspections_vehicle_out_of_service": { "type": "string", "description": "Vehicle inspections resulting in an OOS order.", "example": "72" }, "inspections_hazmat_out_of_service": { "type": "string", "description": "Hazmat inspections resulting in an OOS order.", "example": "0" }, "inspections_vehicle_out_of_service_pct": { "type": "string", "description": "Vehicle OOS rate as a decimal (e.g., 0.24 = 24%).", "example": "0.24" }, "inspections_driver_out_of_service_pct": { "type": "string", "description": "Driver OOS rate as a decimal.", "example": "0.009" }, "inspections_hazmat_out_of_service_pct": { "type": "string", "description": "Hazmat OOS rate as a decimal.", "example": "0" }, "natl_avg_oos_vehicle": { "type": "string", "description": "National average vehicle OOS rate for comparison.", "example": "0.2226" }, "natl_avg_oos_driver": { "type": "string", "description": "National average driver OOS rate.", "example": "0.0667" }, "natl_avg_oos_hazmat": { "type": "string", "description": "National average hazmat OOS rate.", "example": "0.0444" }, "oos_alert_driver": { "type": "boolean", "description": "True if driver OOS rate significantly exceeds national average.", "example": false }, "oos_alert_vehicle": { "type": "boolean", "description": "True if vehicle OOS rate significantly exceeds national average.", "example": true }, "oos_alert_hazmat": { "type": "boolean", "description": "True if hazmat OOS rate significantly exceeds national average.", "example": false }, "inspected_states": { "type": "string", "description": "Number of distinct states where this carrier has been inspected.", "example": "32" }, "inspected_power_units": { "type": "string", "description": "Number of distinct power units inspected.", "example": "452" }, "inspected_trailers": { "type": "string", "description": "Number of distinct trailers inspected.", "example": "446" }, "last_inspection_date": { "type": "string", "description": "Date of the most recent inspection.", "example": "2026-02-26" }, "inspection_history": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Historical inspection detail records." }, "crashes_total": { "type": "string", "description": "Total reportable crashes.", "example": "69" }, "crash_fatalities": { "type": "string", "description": "Total fatalities from crashes.", "example": "2" }, "crash_injuries": { "type": "string", "description": "Total injuries from crashes.", "example": "18" }, "crashes_tow_away": { "type": "string", "description": "Total tow-away crashes.", "example": "49" }, "last_crash_date": { "type": "string", "description": "Date of the most recent crash (YYYY-MM-DD).", "example": "2026-02-13" }, "crash_history": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Individual crash records with details." }, "crash_aggregates": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Crash summary aggregated by time period." }, "total_power_units": { "type": "string", "description": "Total power units (trucks + tractors). The industry-standard fleet size metric.", "example": "897" }, "total_drivers": { "type": "string", "description": "Total drivers reported on MCS-150.", "example": "897" }, "total_drivers_cdl": { "type": "string", "description": "Total drivers holding a CDL.", "example": "897" }, "owned_tractors": { "type": "string", "description": "Company-owned tractors.", "example": "659" }, "term_leased_tractors": { "type": "string", "description": "Term-leased tractors.", "example": "238" }, "owned_trailers": { "type": "string", "description": "Company-owned trailers.", "example": "659" }, "term_leased_trailers": { "type": "string", "description": "Term-leased trailers.", "example": "238" }, "total_trailers": { "type": "string", "description": "Total trailers (owned + leased).", "example": "897" }, "total_trucks": { "type": "string", "description": "Total trucks (typically equals total_power_units).", "example": "897" }, "total_buses": { "type": "string", "description": "Total buses.", "example": "0" }, "num_drivers_interstate_total": { "type": "string", "description": "Drivers operating in interstate commerce.", "example": "897" }, "num_drivers_interstate_within_100mi": { "type": "string", "description": "Interstate drivers within 100-mile radius.", "example": "0" }, "num_drivers_interstate_beyond_100mi": { "type": "string", "description": "Interstate drivers beyond 100-mile radius.", "example": "897" }, "num_drivers_intrastate_total": { "type": "string", "description": "Drivers operating in intrastate commerce.", "example": "0" }, "num_drivers_intrastate_within_100mi": { "type": "string", "description": "Intrastate drivers within 100-mile radius.", "example": "0" }, "num_drivers_intrastate_beyond_100mi": { "type": "string", "description": "Intrastate drivers beyond 100-mile radius.", "example": "0" }, "avg_trip_leased_drivers": { "type": "string", "description": "Average trip-leased drivers.", "example": "0" }, "telephone_number": { "type": "string", "description": "Primary phone number (digits only).", "example": "5624304100" }, "fax_number": { "type": "string", "description": "Fax number.", "example": "5624304144" }, "cellphone_number": { "type": "string", "description": "Cell phone number.", "example": "3153176157" }, "email_address": { "type": "string", "description": "Primary email address.", "example": "SRUIZ@HANSENADKINS.COM" }, "email_domain": { "type": "string", "description": "Email domain (extracted from email_address).", "example": "HANSENADKINS" }, "company_contact_primary": { "type": "string", "description": "Primary company officer or contact person.", "example": "STEVEN HANSEN" }, "company_contact_secondary": { "type": "string", "description": "Secondary contact person.", "example": "LOUIE ADKINS" }, "physical_address": { "type": "string", "description": "Full physical address string.", "example": "3552 GREEN AVENUE, LOS ALAMITOS, CA 90720" }, "physical_address_street": { "type": "string", "description": "Street address.", "example": "3552 GREEN AVENUE" }, "physical_address_city": { "type": "string", "description": "City.", "example": "LOS ALAMITOS" }, "physical_address_state": { "type": "string", "description": "Two-letter state code.", "example": "CA" }, "physical_address_zip_code": { "type": "string", "description": "ZIP code.", "example": "90720" }, "physical_address_iso_country_code": { "type": "string", "description": "ISO country code.", "example": "US" }, "undeliverable_physical_address": { "type": "boolean", "description": "True if the physical address is flagged as undeliverable.", "example": false }, "mailing_address": { "type": "string", "description": "Full mailing address string.", "example": "3552 GREEN AVENUE, LOS ALAMITOS, CA 90720" }, "mailing_address_street": { "type": "string", "description": "Mailing street address.", "example": "3552 GREEN AVENUE" }, "mailing_address_city": { "type": "string", "description": "Mailing city.", "example": "LOS ALAMITOS" }, "mailing_address_state": { "type": "string", "description": "Mailing state.", "example": "CA" }, "mailing_address_zip_code": { "type": "string", "description": "Mailing ZIP code.", "example": "90720" }, "mailing_address_iso_country_code": { "type": "string", "description": "Mailing ISO country code.", "example": "US" }, "undeliverable_mailing_address": { "type": "boolean", "description": "True if the mailing address is flagged as undeliverable.", "example": false }, "physical_address_authority": { "type": "string", "description": "Address on file with authority registration.", "example": "3552 GREEN AVENUE, LOS ALAMITOS, CA 90720" }, "physical_address_authority_street": { "type": "string", "description": "Authority registration street.", "example": "3552 GREEN AVENUE" }, "physical_address_authority_city": { "type": "string", "description": "Authority registration city.", "example": "LOS ALAMITOS" }, "physical_address_authority_state": { "type": "string", "description": "Authority registration state.", "example": "CA" }, "physical_address_authority_zip_code": { "type": "string", "description": "Authority registration ZIP.", "example": "90720" }, "physical_telephone_number_authority": { "type": "string", "description": "Phone on file with authority registration.", "example": "5624304100" }, "physical_fax_number_authority": { "type": "string", "description": "Fax on file with authority registration.", "example": "5624304144" }, "undeliverable_physical_address_authority": { "type": "boolean", "description": "True if authority registration address is undeliverable.", "example": false }, "physical_address_id": { "type": "string", "description": "Unique hash ID for the physical address (used in network graph).", "example": "-6155238..." }, "mailing_address_id": { "type": "string", "description": "Unique hash ID for the mailing address.", "example": "-6155238..." }, "physical_address_authority_id": { "type": "string", "description": "Unique hash ID for the authority registration address.", "example": "-6155238..." }, "address_ids": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "All address hash IDs associated with this carrier." }, "cargo_carried": { "type": "string", "description": "Primary cargo description.", "example": "Motor Vehicles" }, "general_freight": { "type": "boolean", "description": "Authorized for general freight.", "example": false }, "household": { "type": "boolean", "description": "Authorized for household goods.", "example": false }, "metal_sheet_coils_rolls": { "type": "boolean", "description": "Authorized for metal sheets, coils, rolls.", "example": false }, "motor_vehicles": { "type": "boolean", "description": "Authorized for motor vehicles.", "example": true }, "driveaway_towaway": { "type": "boolean", "description": "Authorized for driveaway/towaway.", "example": false }, "logs_poles_beams_lumber": { "type": "boolean", "description": "Authorized for logs, poles, beams, lumber.", "example": false }, "building_materials": { "type": "boolean", "description": "Authorized for building materials.", "example": false }, "mobile_homes": { "type": "boolean", "description": "Authorized for mobile homes.", "example": false }, "machinery_large_objects": { "type": "boolean", "description": "Authorized for machinery and large objects.", "example": false }, "fresh_produce": { "type": "boolean", "description": "Authorized for fresh produce.", "example": false }, "liquids_gases": { "type": "boolean", "description": "Authorized for liquids and gases.", "example": false }, "intermodal_containers": { "type": "boolean", "description": "Authorized for intermodal containers.", "example": false }, "passengers": { "type": "boolean", "description": "Authorized for passengers.", "example": false }, "oilfield_equipment": { "type": "boolean", "description": "Authorized for oilfield equipment.", "example": false }, "livestock": { "type": "boolean", "description": "Authorized for livestock.", "example": false }, "grain_feed_hay": { "type": "boolean", "description": "Authorized for grain, feed, hay.", "example": false }, "coal_coke": { "type": "boolean", "description": "Authorized for coal, coke.", "example": false }, "meat": { "type": "boolean", "description": "Authorized for meat.", "example": false }, "garbage_refuse_trash": { "type": "boolean", "description": "Authorized for garbage, refuse, trash.", "example": false }, "chemicals": { "type": "boolean", "description": "Authorized for chemicals.", "example": false }, "us_mail": { "type": "boolean", "description": "Authorized for US mail.", "example": false }, "dry_bulk_commodities": { "type": "boolean", "description": "Authorized for dry bulk commodities.", "example": false }, "refrigerated_foods": { "type": "boolean", "description": "Authorized for refrigerated foods.", "example": false }, "beverages": { "type": "boolean", "description": "Authorized for beverages.", "example": false }, "paper_products": { "type": "boolean", "description": "Authorized for paper products.", "example": false }, "utility": { "type": "boolean", "description": "Authorized for utilities.", "example": false }, "farm_supplies": { "type": "boolean", "description": "Authorized for farm supplies.", "example": false }, "construction": { "type": "boolean", "description": "Authorized for construction.", "example": false }, "water_well": { "type": "boolean", "description": "Authorized for water well.", "example": false }, "other_cargo": { "type": "boolean", "description": "Authorized for other/miscellaneous cargo.", "example": false }, "operation_classification_desc": { "type": "string", "description": "Primary operation classification.", "example": "Authorized For Hire" }, "operation_class_authorized_for_hire": { "type": "boolean", "description": "Authorized for-hire carrier.", "example": true }, "operation_class_exempt_for_hire": { "type": "boolean", "description": "Exempt for-hire carrier.", "example": false }, "operation_class_private_property": { "type": "boolean", "description": "Private (property) carrier.", "example": false }, "operation_class_private_pass_business": { "type": "boolean", "description": "Private passenger (business).", "example": false }, "operation_class_private_pass_non_business": { "type": "boolean", "description": "Private passenger (non-business).", "example": false }, "operation_class_migrant": { "type": "boolean", "description": "Migrant carrier.", "example": false }, "operation_class_us_mail": { "type": "boolean", "description": "US Mail carrier.", "example": false }, "operation_class_federal_govt": { "type": "boolean", "description": "Federal government carrier.", "example": false }, "operation_class_state_govt": { "type": "boolean", "description": "State government carrier.", "example": false }, "operation_class_local_govt": { "type": "boolean", "description": "Local government carrier.", "example": false }, "operation_class_indian_nation": { "type": "boolean", "description": "Indian nation carrier.", "example": false }, "mcs150_date": { "type": "string", "description": "Date of the most recent MCS-150 biennial update (YYYY-MM-DD).", "example": "2024-10-30" }, "mcs150_year": { "type": "string", "description": "Year of the most recent MCS-150 update.", "example": "2024" }, "mcs150_mileage": { "type": "string", "description": "Annual mileage reported on MCS-150.", "example": "58703744" }, "mcs151_type_desc": { "type": "string", "description": "Type of the last MCS-151 review.", "example": "Compliance Review" }, "mcs151_date": { "type": "string", "description": "Date of the last MCS-151 review.", "example": "2021-07-29" }, "mcs151_year": { "type": "string", "description": "Year of the last MCS-151 review.", "example": "2021" }, "boc3_company_name": { "type": "string", "description": "Process agent company name.", "example": "1+49 PROCESS AGENTS LLC" }, "boc3_attn": { "type": "string", "description": "Process agent attention/contact.", "example": "MATTHEW BOWLES" }, "boc3_address_street": { "type": "string", "description": "Process agent street address.", "example": "6250 SHILOH ROAD SUITE230" }, "bo3_address_city": { "type": "string", "description": "Process agent city (note: field name has typo in API).", "example": "ALPHARETTA" }, "boc3_address_state": { "type": "string", "description": "Process agent state.", "example": "GA" }, "boc3_address_zip_code": { "type": "string", "description": "Process agent ZIP code.", "example": "30005" }, "boc3_address_country_code": { "type": "string", "description": "Process agent country code.", "example": "US" }, "contact_history": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Full change history for all contact fields. Each entry has key (field name), value, start_date, end_date, current_flag." }, "name_change_count": { "type": "string", "description": "Number of legal name changes.", "example": "1" }, "name_last_changed": { "type": "string", "description": "Date of the most recent name change.", "example": "2014-12-18" }, "email_change_count": { "type": "string", "description": "Number of email address changes.", "example": "3" }, "email_last_changed": { "type": "string", "description": "Date of the most recent email change.", "example": "2022-12-30" }, "phone_change_count": { "type": "string", "description": "Number of phone number changes.", "example": "5" }, "phone_last_changed": { "type": "string", "description": "Date of the most recent phone change.", "example": "2022-12-08" }, "address_change_count": { "type": "string", "description": "Number of address changes.", "example": "4" }, "address_last_changed": { "type": "string", "description": "Date of the most recent address change.", "example": "2014-12-18" }, "contact_change_count": { "type": "string", "description": "Number of contact person changes.", "example": "3" }, "contact_last_changed": { "type": "string", "description": "Date of the most recent contact person change.", "example": "2023-11-08" }, "indicator_address_history": { "type": "boolean", "description": "True if address history contains notable patterns.", "example": true }, "indicator_network_graph_contact": { "type": "boolean", "description": "True if this carrier shares contact data with other entities.", "example": true }, "indicator_network_graph_equipment": { "type": "boolean", "description": "True if this carrier shares equipment with other entities.", "example": true }, "network_graph_count_physical_address": { "type": "string", "description": "Entities sharing this physical address.", "example": "2" }, "network_graph_physical_address": { "type": "array", "items": { "type": "string" }, "description": "Details of entities sharing this physical address." }, "network_graph_count_mailing_address": { "type": "string", "description": "Entities sharing this mailing address.", "example": "2" }, "network_graph_mailing_address": { "type": "array", "items": { "type": "string" }, "description": "Details of entities sharing this mailing address." }, "network_graph_count_telephone_numbers": { "type": "string", "description": "Entities sharing this phone number.", "example": "2" }, "network_graph_telephone_number": { "type": "array", "items": { "type": "string" }, "description": "Details of entities sharing this phone." }, "network_graph_count_cellphone_numbers": { "type": "string", "description": "Entities sharing this cell number.", "example": "0" }, "network_graph_cellphone_number": { "type": "array", "items": {}, "description": "Details of entities sharing this cell number." }, "network_graph_count_fax_numbers": { "type": "string", "description": "Entities sharing this fax number.", "example": "1" }, "network_graph_fax_number": { "type": "array", "items": { "type": "string" }, "description": "Details of entities sharing this fax." }, "network_graph_count_email_address": { "type": "string", "description": "Entities sharing this email.", "example": "0" }, "network_graph_email": { "type": "array", "items": {}, "description": "Details of entities sharing this email." }, "network_graph_count_ein": { "type": "string", "description": "Entities sharing this EIN.", "example": "0" }, "network_graph_ein": { "type": "array", "items": {}, "description": "Details of entities sharing this EIN." }, "network_graph_count_duns": { "type": "string", "description": "Entities sharing this DUNS number.", "example": "0" }, "network_graph_duns": { "type": "array", "items": {}, "description": "Details of entities sharing this DUNS." }, "network_graph_count_equipment": { "type": "string", "description": "Distinct equipment units shared with other carriers.", "example": "16" }, "network_graph_equipment": { "type": "array", "items": { "type": "string" }, "description": "Equipment shared with other entities." }, "network_graph_equipment_ext": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Extended equipment network data." }, "network_graph_count_power_units": { "type": "string", "description": "Power units shared with other carriers.", "example": "12" }, "network_graph_count_trailers": { "type": "string", "description": "Trailers shared with other carriers.", "example": "13" }, "shared_power_units": { "type": "string", "description": "Total shared power units.", "example": "17" }, "shared_trailers": { "type": "string", "description": "Total shared trailers.", "example": "17" }, "total_loads": { "type": "string", "description": "Total loads observed.", "example": "402" }, "ltl_loads": { "type": "string", "description": "Less-than-truckload shipments.", "example": "6" }, "ltl_percentage": { "type": "number", "description": "LTL percentage of total loads.", "example": 0.015 }, "ftl_loads": { "type": "string", "description": "Full-truckload shipments.", "example": "396" }, "ftl_percentage": { "type": "number", "description": "FTL percentage of total loads.", "example": 0.985 }, "deadheads": { "type": "string", "description": "Empty (deadhead) moves observed.", "example": "55" }, "deadhead_percentage": { "type": "number", "description": "Deadhead rate as a decimal.", "example": 0.137 }, "first_load_date": { "type": "string", "description": "Date of the earliest observed load.", "example": "2024-03-04" }, "last_load_date": { "type": "string", "description": "Date of the most recent observed load.", "example": "2026-02-26" }, "load_summary": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Load aggregates by time period or lane." }, "preferred_lanes": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Frequently used origin/destination corridors." }, "equipment_summary": { "type": "object", "additionalProperties": true, "description": "JSON summary of fleet equipment by make, model, year, and type." }, "equipment_history": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Historical equipment changes." }, "indicator_industry_benchmarks": { "type": "boolean", "description": "True if any benchmark anomaly is detected.", "example": false }, "observed_IM": { "type": "string", "description": "Observed inspection-to-mileage ratio.", "example": "653" }, "expected_lb_IM": { "type": "string", "description": "Expected lower bound for inspection-to-mileage ratio.", "example": "171" }, "expected_ub_IM": { "type": "string", "description": "Expected upper bound for inspection-to-mileage ratio.", "example": "1097" }, "indicator_benchmark_inspection_mileage_ratio": { "type": "boolean", "description": "True if inspection-to-mileage ratio is outside expected range.", "example": false }, "observed_IRPU": { "type": "string", "description": "Observed inspected-power-units ratio.", "example": "452" }, "expected_lb_IRPU": { "type": "string", "description": "Expected lower bound for inspected-power-units ratio.", "example": "36" }, "expected_ub_IRPU": { "type": "string", "description": "Expected upper bound for inspected-power-units ratio.", "example": "530" }, "indicator_benchmark_inspected_power_units_ratio": { "type": "boolean", "description": "True if inspected-power-units ratio is outside expected range.", "example": false }, "observed_PUM": { "type": "string", "description": "Observed power-unit-to-mileage ratio.", "example": "897" }, "expected_lb_PUM": { "type": "string", "description": "Expected lower bound for power-unit-to-mileage ratio.", "example": "329" }, "expected_ub_PUM": { "type": "string", "description": "Expected upper bound for power-unit-to-mileage ratio.", "example": "897" }, "indicator_benchmark_power_unit_mileage_ratio": { "type": "boolean", "description": "True if power-unit-to-mileage ratio is outside expected range.", "example": false }, "private": { "type": "boolean", "description": "Private carrier (not for-hire).", "example": false }, "enterprise": { "type": "boolean", "description": "Enterprise/large fleet carrier.", "example": false }, "household_goods": { "type": "boolean", "description": "Household goods mover.", "example": false }, "passenger": { "type": "boolean", "description": "Passenger carrier.", "example": false }, "property": { "type": "boolean", "description": "Property carrier.", "example": true }, "hazardous_material": { "type": "boolean", "description": "Authorized for hazardous materials.", "example": true }, "out_of_service_flag": { "type": "boolean", "description": "Currently under an out-of-service order.", "example": false }, "smartway_flag": { "type": "boolean", "description": "EPA SmartWay partner.", "example": true }, "carbtru_flag": { "type": "boolean", "description": "CARB TRU compliant (California).", "example": false }, "phmsa_flag": { "type": "boolean", "description": "PHMSA (Pipeline and Hazardous Materials Safety Administration) registered.", "example": false }, "risk_factors": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Risk factor scores for a specific load. Only populated when event details are submitted via POST request body." }, "geo_points": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Geographic data points associated with the carrier." } }, "additionalProperties": true }, "ProfileSearchResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/CarrierProfile" } }, "total_count": { "type": "integer" } } }, "AutocompleteSuggestion": { "type": "object", "properties": { "dot_number": { "type": "string" }, "legal_name": { "type": "string" }, "dba_name": { "type": "string", "nullable": true }, "city": { "type": "string", "nullable": true }, "state": { "type": "string", "nullable": true } } }, "MonitoringWriteResponse": { "type": "object", "properties": { "status": { "type": "string", "description": "Human-readable status, e.g. 'Profiles added or updated successfully' or 'Profiles removed successfully'." }, "added": { "type": "integer", "description": "Profiles committed to the watchlist (add)." }, "removed": { "type": "integer", "description": "Profiles removed from the watchlist (remove)." }, "error": { "type": "string", "description": "Present only on a 207 partial commit — retry the remainder." } } }, "MonitoringListResponse": { "type": "object", "properties": { "total_count": { "type": "integer", "description": "Total monitored profiles matching the filters." }, "items": { "type": "object", "description": "Changed profiles keyed by profile_id. Each value is the list of fields that changed since you last acknowledged them — each as a {field}_current / {field}_prior / {field}_changed triple.", "additionalProperties": { "type": "array", "items": { "type": "object", "additionalProperties": true } } } } } } }, "paths": { "/v2/profile": { "get": { "operationId": "getV2Profile", "tags": [ "Profiles" ], "summary": "Look up a carrier by USDOT number", "description": "Retrieve a carrier profile using its USDOT number. Returns the full carrier profile including identity, authority, safety, BASIC percentiles, ISS scores, risk factors, insurance, fleet, inspections, violations, and crash history.\n\n**Search by one of:**\n- `dot_number` — DOT: Look up a carrier by USDOT number\n- `docket_number` — Docket Number: Look up a carrier by MC or MX docket number\n- `company` — Company: Search carriers by company name\n- `ein` — EIN: Look up a carrier by Employer Identification Number\n- `email` — Email: Search carriers by email address or domain\n- `address` — Address: Search carriers by physical address\n- `phone` — Phone: Search carriers by phone number\n- `vin` — VIN: Look up carriers associated with a Vehicle Identification Number\n- `plate_number` — Plate: Look up carriers associated with a license plate number\n- `unit_number` — Unit Number: Look up carriers associated with a fleet unit number", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProfileSearchResponse" }, "example": { "items": [ { "dot_number": "568253", "docket_prefix": "MC", "docket_number": "277621", "docket": "MC277621", "ein": "954485461", "carrier_operation_desc": "interstate", "entity_type_desc": "Carrier", "authority_common": "Active", "authority_contract": "Active", "authority_broker": "None", "authority_common_pending": false, "authority_contract_pending": false, "authority_broker_pending": false, "authority_common_review": false, "authority_contract_review": false, "authority_broker_review": false, "authority_common_revocation": false, "authority_age_common": "7937", "authority_age_common_active": "7937", "authority_contract_revocation": false, "authority_age_contract": "11460", "authority_age_contract_active": "11460", "authority_broker_revocation": false, "total_revocations": "2", "days_since_last_revocation": "7954", "indicator_authority": true, "insurance_bipd_on_file": "1000000", "insurance_cargo_on_file": "0", "insurance_bond_on_file": "0", "insurance_bipd_required": "1000000", "insurance_cargo_required": "0", "insurance_bond_required": "0", "indicator_insurance": true, "private": false, "enterprise": false, "household_goods": false, "passenger": false, "property": true, "legal_name": "HANSEN & ADKINS AUTO TRANSPORT INC", "dba_flag": false, "telephone_number": "5624304100", "fax_number": "5624304144", "physical_address_city": "LOS ALAMITOS", "physical_address_iso_country_code": "US", "physical_address_state": "CA", "physical_address_street": "3552 GREEN AVENUE", "physical_address_zip_code": "90720", "physical_address": "3552 GREEN AVENUE, LOS ALAMITOS, CA 90720", "undeliverable_physical_address": false, "mailing_address_iso_country_code": "US", "mailing_address_street": "3552 GREEN AVENUE", "mailing_address_city": "LOS ALAMITOS", "mailing_address_state": "CA", "mailing_address_zip_code": "90720", "mailing_address": "3552 GREEN AVENUE, LOS ALAMITOS, CA 90720", "latest_review_type_desc": "Compliance Review", "safety_rating_desc": "Satisfactory", "usdot_status": "Active", "total_drivers": "897", "total_power_units": "897", "mcs150_mileage": "58703744", "cargo_carried": "Motor Vehicles", "general_freight": false, "household": false, "metal_sheet_coils_rolls": false, "motor_vehicles": true, "driveaway_towaway": false, "logs_poles_beams_lumber": false, "building_materials": false, "mobile_homes": false, "machinery_large_objects": false, "fresh_produce": false, "liquids_gases": false, "intermodal_containers": false, "passengers": false, "oilfield_equipment": false, "livestock": false, "grain_feed_hay": false, "coal_coke": false, "meat": false, "garbage_refuse_trash": false, "chemicals": false, "us_mail": false, "dry_bulk_commodities": false, "refrigerated_foods": false, "beverages": false, "paper_products": false, "utility": false, "farm_supplies": false, "construction": false, "water_well": false, "other_cargo": false, "operation_classification_desc": "Authorized For Hire", "operation_class_authorized_for_hire": true, "operation_class_exempt_for_hire": false, "operation_class_private_property": false, "operation_class_private_pass_business": false, "operation_class_private_pass_non_business": false, "operation_class_migrant": false, "operation_class_us_mail": false, "operation_class_federal_govt": false, "operation_class_state_govt": false, "operation_class_local_govt": false, "operation_class_indian_nation": false, "organization_type_desc": "CORPORATION", "company_contact_primary": "STEVEN HANSEN", "company_contact_secondary": "LOUIE ADKINS", "email_address": "SRUIZ@HANSENADKINS.COM", "email_domain": "HANSENADKINS", "cellphone_number": "3153176157", "undeliverable_mailing_address": false, "icc_dockets": "MC277621", "owned_tractors": "659", "owned_trailers": "659", "term_leased_tractors": "238", "term_leased_trailers": "238", "total_trailers": "897", "total_trucks": "897", "total_buses": "0", "num_drivers_interstate_within_100mi": "0", "num_drivers_interstate_beyond_100mi": "897", "num_drivers_interstate_total": "897", "num_drivers_intrastate_within_100mi": "0", "num_drivers_intrastate_beyond_100mi": "0", "num_drivers_intrastate_total": "0", "avg_trip_leased_drivers": "0", "total_drivers_cdl": "897", "mcs151_type_desc": "Compliance Review", "dot_age": "11563", "boc3_company_name": "1+49 PROCESS AGENTS LLC", "boc3_attn": "MATTHEW BOWLES", "bo3_address_city": "ALPHARETTA", "boc3_address_state": "GA", "boc3_address_street": "6250 SHILOH ROAD SUITE230", "boc3_address_zip_code": "30005", "boc3_address_country_code": "US", "crashes_total": "69", "crash_fatalities": "2", "crash_injuries": "18", "crashes_tow_away": "49", "inspections_driver": "652", "inspections_driver_out_of_service": "6", "oos_alert_driver": false, "inspections_hazmat": "1", "inspections_hazmat_out_of_service": "0", "oos_alert_hazmat": false, "inspections_vehicle": "300", "inspections_vehicle_out_of_service": "72", "oos_alert_vehicle": true, "violations_total": "472", "violations_unsafe_driving": "89", "violations_severe_unsafe_driving": "26", "violations_oos_unsafe_driving": "0", "basic_alert_unsafe_driving": false, "basic_roadside_alert_unsafe_driving": false, "basic_ac_indicator_unsafe_driving": false, "intervention_threshold_unsafe_driving": 0, "violations_hours_of_service": "16", "violations_severe_hours_of_service": "6", "violations_oos_hours_of_service": "0", "basic_alert_hours_of_service": false, "basic_roadside_alert_hours_of_service": false, "basic_ac_indicator_hours_of_service": false, "intervention_threshold_hours_of_service": 0, "violations_vehicle_maintence": "232", "violations_severe_vehicle_maintence": "54", "violations_oos_vehicle_maintence": "84", "basic_alert_vehicle_maintence": false, "basic_roadside_alert_vehicle_maintence": false, "basic_ac_indicator_vehicle_maintence": false, "intervention_threshold_vehicle_maintence": 0, "violations_controlled_substance": "0", "violations_severe_controlled_substance": "0", "violations_oos_controlled_substance": "0", "basic_alert_controlled_substance": false, "basic_roadside_alert_controlled_substance": false, "basic_ac_indicator_controlled_substance": false, "intervention_threshold_controlled_substance": 0, "violations_driver_fitness": "7", "violations_severe_driver_fitness": "5", "violations_oos_driver_fitness": "7", "basic_alert_driver_fitness": false, "basic_roadside_alert_driver_fitness": false, "basic_ac_indicator_driver_fitness": false, "intervention_threshold_driver_fitness": 0, "violations_hazardous_materials": "0", "violations_severe_hazardous_materials": "0", "violations_oos_hazardous_materials": "0", "basic_measure_hazardous_materials": 0, "basic_alert_hazardous_materials": false, "basic_roadside_alert_hazardous_materials": false, "basic_ac_indicator_hazardous_materials": false, "intervention_threshold_hazardous_materials": 0, "basic_measure_crash_indicator": 0.15217391304347827, "basic_percentile_crash_indicator": 0.19014084507042253, "basic_alert_crash_indicator": false, "basic_roadside_alert_crash_indicator": false, "intervention_threshold_crash_indicator": 0.65, "inspections_total": "653", "inspected_states": "32", "inspected_power_units": "452", "inspected_trailers": "446", "physical_telephone_number_authority": "5624304100", "physical_fax_number_authority": "5624304144", "physical_address_authority_city": "LOS ALAMITOS", "physical_address_authority_state": "CA", "physical_address_authority_street": "3552 GREEN AVENUE", "physical_address_authority_zip_code": "90720", "physical_address_authority": "3552 GREEN AVENUE, LOS ALAMITOS, CA 90720", "undeliverable_physical_address_authority": false, "out_of_service_flag": false, "hazardous_material": true, "physical_address_id": "-6155238544422854689", "mailing_address_id": "-6155238544422854689", "physical_address_authority_id": "-6155238544422854689", "mcs150_date": "2024-10-30", "mcs150_year": "2024", "mcs151_date": "2021-07-29", "mcs151_year": "2021", "added_date": "1994-07-07", "authority_start_common": "2004-06-10", "authority_start_contract": "1994-10-18", "authority_common_last_revocation_date": "2004-05-24", "last_revocation_date": "2004-05-24", "last_violation_date": "2026-02-26", "last_crash_date": "2026-02-13", "last_inspection_date": "2026-02-26", "latest_review_date": "2021-07-29", "safety_rating_date": "2021-12-17", "snapshot_date": "2026-03-04", "basic_measure_unsafe_driving": "0", "basic_measure_hours_of_service": "0", "basic_measure_vehicle_maintence": "0", "basic_measure_controlled_substance": "0", "basic_measure_driver_fitness": "0", "inspections_vehicle_out_of_service_pct": "0.24", "inspections_driver_out_of_service_pct": "0.009", "inspections_hazmat_out_of_service_pct": "0", "natl_avg_oos_vehicle": "0.2226", "natl_avg_oos_driver": "0.0667", "natl_avg_oos_hazmat": "0.0444", "smartway_flag": true, "carbtru_flag": false, "phmsa_flag": false, "contact_history": [ { "_id": "fde40b92-daa2-488e-a82e-aca8e6ecc8fe", "key": "dba_name", "value": "HANSEN & ADKINS AUTO TRANSPORT", "start_date": "2005-12-23", "end_date": "2026-03-04", "current_flag": true }, { "_id": "9b1c0235-bbaa-4ca7-9dc7-7a03dab3972b", "key": "mailing_address", "value": "3552 GREEN AVENUE, LOS ALAMITOS, CA 90720", "start_date": "2014-12-19", "end_date": "2026-03-04", "current_flag": true } ], "name_change_count": "1", "name_last_changed": "2014-12-18", "email_change_count": "3", "email_last_changed": "2022-12-30", "phone_change_count": "5", "phone_last_changed": "2022-12-08", "address_change_count": "4", "address_last_changed": "2014-12-18", "contact_change_count": "3", "contact_last_changed": "2023-11-08", "indicator_address_history": true, "risk_score": "Low", "risk_score_probability": 0.21698243104234227, "iss_value": "45", "iss_recommendation": "PASS", "iss_recommendation_reason": "Sufficient Data - No BASICs Prioritized", "safety_score": "100", "indicator_carrier_safety": false, "indicator_industry_benchmarks": false, "observed_IM": "653", "expected_lb_IM": "171", "expected_ub_IM": "1097", "indicator_benchmark_inspection_mileage_ratio": false, "observed_IRPU": "452", "expected_lb_IRPU": "36", "expected_ub_IRPU": "530", "indicator_benchmark_inspected_power_units_ratio": false, "observed_PUM": "897", "expected_lb_PUM": "329", "expected_ub_PUM": "897", "indicator_benchmark_power_unit_mileage_ratio": false, "indicator_network_graph_contact": true, "address_ids": [ { "_id": "8a4b7566-f980-4b12-afc2-5539dd521eed", "key": "physical_address_authority_id", "value": "-6155238544422854689", "start_date": "2023-11-08", "end_date": "2026-03-04", "current_flag": true }, { "_id": "84147a19-fe24-4f21-a917-042225e9042f", "key": "physical_address_id", "value": "-6155238544422854689", "start_date": "2014-12-19", "end_date": "2026-03-04", "current_flag": true }, { "_id": "9bdcfe40-0cfa-46a5-bf87-6bdab5d7989e", "key": "mailing_address_id", "value": "-6155238544422854689", "start_date": "2014-12-19", "end_date": "2026-03-04", "current_flag": true }, { "_id": "a452bf75-5e91-41a3-8e07-a4710a137280", "key": "mailing_address_id", "value": "892318786047236894", "start_date": "2007-12-20", "end_date": "2014-12-18", "current_flag": false }, { "_id": "d60a81d5-74ca-429c-9a37-000bb461a4f2", "key": "physical_address_id", "value": "892318786047236894", "start_date": "2007-12-20", "end_date": "2014-12-18", "current_flag": false }, { "_id": "5711e9f0-8ed9-497f-8733-50866f54b49d", "key": "mailing_address_id", "value": "-6312204236195345298", "start_date": "2005-12-23", "end_date": "2007-12-19", "current_flag": false }, { "_id": "ced84355-1f6a-464d-9923-2513c5b99fc2", "key": "physical_address_id", "value": "-6312204236195345298", "start_date": "2005-12-23", "end_date": "2007-12-19", "current_flag": false } ], "network_graph_count_physical_address": "2", "network_graph_physical_address": [ "3725123", "1312746" ], "network_graph_count_mailing_address": "2", "network_graph_mailing_address": [ "3725123", "1312746" ], "network_graph_count_telephone_numbers": "2", "network_graph_telephone_number": [ "3725123", "1312746" ], "network_graph_count_cellphone_numbers": "0", "network_graph_cellphone_number": [], "network_graph_count_fax_numbers": "1", "network_graph_fax_number": [ "1312746" ], "network_graph_count_email_address": "0", "network_graph_email": [], "network_graph_count_ein": "0", "network_graph_ein": [], "network_graph_count_duns": "0", "network_graph_duns": [], "indicator_network_graph_equipment": true, "network_graph_count_equipment": "16", "network_graph_equipment": [ "972702", "2541970", "4403125", "3665514", "64161", "2498811", "790261", "2163063", "2324917", "511412", "345082", "3185588", "710576", "2136888", "4100893", "2941959" ], "network_graph_equipment_ext": [ { "_id": "790261", "dot_number": "790261", "dockets": "MC343084", "legal_name": "URS MIDWEST LLC", "entity_type_desc": "Broker,Carrier", "usdot_status": "Active", "out_of_service_flag": false, "carrier_operation_desc": "interstate", "hazardous_material_flag": true, "count_shared_vins": "6", "shared_vins": [ { "vin": "1NPXD49X5FD260155", "type": "POWER UNIT", "unit_type_desc": "Truck Tractor", "primary_category": "Truck Tractor", "features": [ "Diesel" ], "insp_unit_license": "RC45636", "insp_unit_license_state": "MI", "insp_unit_company": "91214", "inspections_total_vin_dot": "1", "last_inspection_date_vin_dot": "2024-12-13", "last_inspected_under_dot": "790261", "most_recent_inspection_flag": true, "make": "PETERBILT", "model": "389", "model_year": "2015", "vehicle_type": "INCOMPLETE VEHICLE", "gvwr": "Class 8: 33,001 lb and above (14,969 kg and above)", "body_class": "Truck-Tractor", "ncsa_body_type": "Truck-tractor (Cab only, or with any number of trailing unit; any weight)" }, { "vin": "5E0AA1444HG912802", "type": "TRAILER", "unit_type_desc": "Semi Trailer", "primary_category": "Auto Carrier", "secondary_category": "Open Auto Carrier", "features": [], "insp_unit_license": "423819T", "insp_unit_license_state": "TN", "insp_unit_company": "91215", "inspections_total_vin_dot": "1", "last_inspection_date_vin_dot": "2024-12-13", "last_inspected_under_dot": "790261", "most_recent_inspection_flag": true, "make": "COTTRELL", "model": "C-09, C-11, CS-10, CS-12M3, CX-09, CX-5LSCH, CX-AK7, CX-LSFA-TRI", "model_year": "2017", "vehicle_type": "TRAILER", "body_class": "Trailer", "other_trailer_info": "Trailer Length (feet): 44-46", "trailer_body_type": "Auto Transporter", "trailer_type": "Fifth Wheel" }, { "vin": "3ALHG3DV0MDML6967", "type": "POWER UNIT", "unit_type_desc": "Truck Tractor", "primary_category": "Chassis Cab", "features": [ "Diesel" ], "insp_unit_license": "RC52328", "insp_unit_license_state": "MI", "insp_unit_company": "92004", "inspections_total_vin_dot": "1", "last_inspection_date_vin_dot": "2025-11-08", "last_inspected_under_dot": "790261", "most_recent_inspection_flag": true, "make": "FREIGHTLINER", "model": "114SD", "model_year": "2021", "vehicle_type": "INCOMPLETE VEHICLE", "gvwr": "Class 8: 33,001 lb and above (14,969 kg and above)", "body_class": "Truck", "ncsa_body_type": "Single-unit straight truck or Cab-Chassis (GVWR greater than 26,000 lbs.)", "body_cab_type": "MDHD: Conventional" }, { "vin": "5KKHAEDV8LPLU0719", "type": "POWER UNIT", "unit_type_desc": "Straight Truck", "primary_category": "Straight Truck", "features": [ "Diesel" ], "insp_unit_license": "RC45478", "insp_unit_license_state": "MI", "insp_unit_company": "94598", "inspections_total_vin_dot": "3", "last_inspection_date_vin_dot": "2026-01-17", "last_inspected_under_dot": "790261", "most_recent_inspection_flag": true, "make": "WESTERN STAR", "model": "4900", "model_year": "2020", "vehicle_type": "INCOMPLETE VEHICLE", "gvwr": "Class 8: 33,001 lb and above (14,969 kg and above)", "body_class": "Truck", "ncsa_body_type": "Single-unit straight truck or Cab-Chassis (GVWR greater than 26,000 lbs.)", "body_cab_type": "MDHD: Conventional" }, { "vin": "5E0AA1641NG580701", "type": "TRAILER", "unit_type_desc": "Semi Trailer", "primary_category": "Auto Carrier", "secondary_category": "Open Auto Carrier", "features": [], "insp_unit_license": "94599", "insp_unit_license_state": "TN", "insp_unit_company": "94599", "inspections_total_vin_dot": "3", "last_inspection_date_vin_dot": "2026-01-17", "last_inspected_under_dot": "790261", "most_recent_inspection_flag": true, "make": "COTTRELL", "model": "C-09, C-11, CS-10, CS-12M3, CX-09, CX-5LSCH, CX-AK7, CX-LSFA-TRI", "model_year": "2022", "vehicle_type": "TRAILER", "body_class": "Trailer", "other_trailer_info": "Trailer Length (feet): 48-50", "trailer_body_type": "Auto Transporter", "trailer_type": "Fifth Wheel" }, { "vin": "5E0AA164XMG539501", "type": "TRAILER", "unit_type_desc": "Semi Trailer", "primary_category": "Auto Carrier", "secondary_category": "Open Auto Carrier", "features": [], "insp_unit_license": "4TL4786", "insp_unit_license_state": "CA", "insp_unit_company": "CX-09LSFA3", "inspections_total_vin_dot": "1", "last_inspection_date_vin_dot": "2025-11-08", "last_inspected_under_dot": "790261", "most_recent_inspection_flag": true, "make": "COTTRELL", "model": "C-09, C-11, CS-10, CS-12M3, CX-09, CX-5LSCH, CX-AK7, CX-LSFA-TRI", "model_year": "2021", "vehicle_type": "TRAILER", "body_class": "Trailer", "other_trailer_info": "Trailer Length (feet): 48-50", "trailer_body_type": "Auto Transporter", "trailer_type": "Fifth Wheel" } ], "count_shared_power_units": "3", "count_shared_trailers": "3" }, { "_id": "64161", "dot_number": "64161", "dockets": "MC71902", "legal_name": "JACK COOPER TRANSPORT COMPANY LLC", "entity_type_desc": "Carrier", "usdot_status": "Active", "out_of_service_flag": false, "carrier_operation_desc": "interstate", "hazardous_material_flag": true, "count_shared_vins": "4", "shared_vins": [ { "vin": "5E0AA164XNG605109", "type": "TRAILER", "unit_type_desc": "Semi Trailer", "primary_category": "Auto Carrier", "secondary_category": "Open Auto Carrier", "features": [], "insp_unit_license": "655891", "insp_unit_license_state": "KS", "insp_unit_company": "4550", "inspections_total_vin_dot": "1", "last_inspection_date_vin_dot": "2024-10-23", "last_inspected_under_dot": "568253", "most_recent_inspection_flag": false, "make": "COTTRELL", "model": "C-09, C-11, CS-10, CS-12M3, CX-09, CX-5LSCH, CX-AK7, CX-LSFA-TRI", "model_year": "2022", "vehicle_type": "TRAILER", "body_class": "Trailer", "other_trailer_info": "Trailer Length (feet): 48-50", "trailer_body_type": "Auto Transporter", "trailer_type": "Fifth Wheel" }, { "vin": "1FVHG3DV0MHMJ6115", "type": "POWER UNIT", "unit_type_desc": "Straight Truck", "primary_category": "Chassis Cab", "features": [ "Diesel" ], "insp_unit_license": "200110", "insp_unit_license_state": "KS", "insp_unit_company": "4351", "inspections_total_vin_dot": "1", "last_inspection_date_vin_dot": "2024-05-08", "last_inspected_under_dot": "568253", "most_recent_inspection_flag": false, "make": "FREIGHTLINER", "model": "114SD", "model_year": "2021", "vehicle_type": "INCOMPLETE VEHICLE", "gvwr": "Class 8: 33,001 lb and above (14,969 kg and above)", "body_class": "Truck", "ncsa_body_type": "Single-unit straight truck or Cab-Chassis (GVWR greater than 26,000 lbs.)", "body_cab_type": "MDHD: Conventional" }, { "vin": "1FVHG3DV7MHMJ6189", "type": "POWER UNIT", "unit_type_desc": "Truck Tractor", "primary_category": "Chassis Cab", "features": [ "Diesel" ], "insp_unit_license": "205199", "insp_unit_license_state": "KS", "insp_unit_company": "4549", "inspections_total_vin_dot": "1", "last_inspection_date_vin_dot": "2024-10-23", "last_inspected_under_dot": "568253", "most_recent_inspection_flag": false, "make": "FREIGHTLINER", "model": "114SD", "model_year": "2021", "vehicle_type": "INCOMPLETE VEHICLE", "gvwr": "Class 8: 33,001 lb and above (14,969 kg and above)", "body_class": "Truck", "ncsa_body_type": "Single-unit straight truck or Cab-Chassis (GVWR greater than 26,000 lbs.)", "body_cab_type": "MDHD: Conventional" }, { "vin": "5E0AA1640MG525803", "type": "TRAILER", "unit_type_desc": "Semi Trailer", "primary_category": "Auto Carrier", "secondary_category": "Open Auto Carrier", "features": [], "insp_unit_license": "655676", "insp_unit_license_state": "KS", "insp_unit_company": "4352", "inspections_total_vin_dot": "1", "last_inspection_date_vin_dot": "2024-05-08", "last_inspected_under_dot": "568253", "most_recent_inspection_flag": false, "make": "COTTRELL", "model": "C-09, C-11, CS-10, CS-12M3, CX-09, CX-5LSCH, CX-AK7, CX-LSFA-TRI", "model_year": "2021", "vehicle_type": "TRAILER", "body_class": "Trailer", "other_trailer_info": "Trailer Length (feet): 48-50", "trailer_body_type": "Auto Transporter", "trailer_type": "Fifth Wheel" } ], "count_shared_power_units": "2", "count_shared_trailers": "2" } ], "network_graph_count_power_units": "12", "network_graph_count_trailers": "13", "shared_power_units": "17", "shared_trailers": "17", "preferred_lanes": [ { "state": "US-TX", "inspections": "65" }, { "state": "US-IN", "inspections": "15" }, { "state": "US-MO", "inspections": "10" }, { "state": "US-US", "inspections": "8" }, { "state": "US-FL", "inspections": "68" }, { "state": "US-LA", "inspections": "25" }, { "state": "US-WA", "inspections": "67" }, { "state": "US-MS", "inspections": "22" }, { "state": "US-SC", "inspections": "40" }, { "state": "US-CA", "inspections": "78" }, { "state": "US-OR", "inspections": "10" }, { "state": "US-TN", "inspections": "38" }, { "state": "US-IL", "inspections": "13" }, { "state": "US-MD", "inspections": "12" }, { "state": "US-WI", "inspections": "2" }, { "state": "US-OH", "inspections": "7" }, { "state": "US-ID", "inspections": "10" }, { "state": "US-GA", "inspections": "59" }, { "state": "US-MT", "inspections": "10" }, { "state": "US-AL", "inspections": "26" }, { "state": "US-NC", "inspections": "22" }, { "state": "US-KY", "inspections": "13" }, { "state": "US-MI", "inspections": "12" }, { "state": "US-AR", "inspections": "5" }, { "state": "US-IA", "inspections": "3" }, { "state": "US-NM", "inspections": "1" }, { "state": "US-NY", "inspections": "1" }, { "state": "US-OK", "inspections": "2" }, { "state": "US-NV", "inspections": "3" }, { "state": "US-NE", "inspections": "2" }, { "state": "US-PA", "inspections": "1" }, { "state": "US-KS", "inspections": "1" }, { "state": "US-WV", "inspections": "2" } ], "authority_history": [ { "_id": "a165740f-801b-45c7-bdee-576e0bdce69b", "authority_type_desc": "Motor Property Common Carrier", "original_action_desc": "Reinstated", "original_served_date": "2004-06-10" }, { "_id": "79f326ff-0a66-4629-91a1-c29d42aea15e", "authority_type_desc": "Motor Property Common Carrier", "original_action_desc": "Granted", "original_served_date": "1994-10-18", "dispensation_action_desc": "Revoked", "dispensation_served_date": "2004-05-24" }, { "_id": "3bc66887-80b8-488a-82d1-418ccd351752", "authority_type_desc": "Motor Property Contract Carrier", "original_action_desc": "Granted", "original_served_date": "1994-10-18" } ], "equipment_summary": { "primary_category": [ { "type": "TRAILER", "category": "Auto Carrier", "count": "434" }, { "type": "POWER UNIT", "category": "Chassis Cab", "count": "360" }, { "type": "POWER UNIT", "category": "Truck Tractor", "count": "55" }, { "type": "POWER UNIT", "category": "Straight Truck", "count": "46" }, { "type": "TRAILER", "category": "Unclassified", "count": "15" }, { "type": "POWER UNIT", "category": "Unclassified", "count": "9" }, { "type": "TRAILER", "category": "Dry Van", "count": "4" } ], "secondary_category": [ { "type": "POWER UNIT", "count": "466" }, { "type": "TRAILER", "category": "Open Auto Carrier", "count": "434" }, { "type": "TRAILER", "count": "15" }, { "type": "POWER UNIT", "category": "Sleeper Cab", "count": "4" }, { "type": "TRAILER", "category": "Standard Dry Van", "count": "4" } ] }, "equipment_history": [ { "_id": "b675e929-551b-4d63-bd44-8f276e0dc9be", "vin": "1XP5DB8X5TN385780", "type": "POWER UNIT", "unit_type_desc": "Truck Tractor", "primary_category": "Truck Tractor", "insp_unit_license": "R189019", "insp_unit_license_state": "TX", "insp_unit_company": "50", "inspections_total_vin": "1", "inspections_total_vin_dot": "1", "countd_dots_vin": "1", "multi_dot_flag": false, "last_inspection_date_vin": "2026-01-17", "last_inspection_date_vin_dot": "2026-01-17", "last_inspected_under_dot": "568253", "most_recent_inspection_flag": true, "make": "PETERBILT", "model": "379", "model_year": "1996", "vehicle_type": "TRUCK", "gvwr": "Class 8: 33,001 lb and above (14,969 kg and above)", "body_class": "Truck-Tractor", "ncsa_body_type": "Truck-tractor (Cab only, or with any number of trailing unit; any weight)", "body_cab_type": "MDHD: Conventional" }, { "_id": "238f5f2a-e13e-4b8f-bf0d-1a86d89c5fb8", "vin": "4V599RDG2FN184099", "type": "POWER UNIT", "unit_type_desc": "Truck Tractor", "primary_category": "Unclassified", "insp_unit_license": "YP78755", "insp_unit_license_state": "CA", "inspections_total_vin": "1", "inspections_total_vin_dot": "1", "countd_dots_vin": "1", "multi_dot_flag": false, "last_inspection_date_vin": "2024-02-13", "last_inspection_date_vin_dot": "2024-02-13", "last_inspected_under_dot": "568253", "most_recent_inspection_flag": true, "make": "VOLVO TRUCK", "model_year": "1985", "vehicle_type": "INCOMPLETE VEHICLE", "body_class": "Incomplete", "ncsa_body_type": "Unknown medium/heavy truck type", "fuel_type_primary": "Diesel" } ], "total_loads": "402", "ltl_loads": "6", "ltl_percentage": 0.014925373134328358, "ftl_loads": "396", "ftl_percentage": 0.9850746268656716, "deadheads": "55", "deadhead_percentage": 0.13681592039800994, "first_load_date": "2024-03-04", "last_load_date": "2026-02-26", "load_summary": [ { "_id": "ba9f4c24-c7cc-421e-acc3-ef9473a5bdc7", "key": "TOYOTA", "value": "20", "first_load_date": "2024-03-14", "last_load_date": "2026-02-26" }, { "_id": "ec9aa9b1-55e3-4c6c-9249-44d385291476", "key": "FORD", "value": "15", "first_load_date": "2024-04-11", "last_load_date": "2026-02-03" } ], "insurance_history": [ { "_id": "ebcc0192-c5a1-44f5-af6d-8f89b8877e87", "insurance_status": "A", "insurance_form_code": "82", "insurance_type_code": "BIPD", "insurance_carrier": "U. S. SPECIALTY INSURANCE COMPANY", "policy_number": "1001120614", "effective_date": "2019-02-27", "underlying_limit_amount": "0", "minimum_coverage_amount": "0" }, { "_id": "e408bbfe-a51b-490f-936f-2a0aab8bfc87", "insurance_status": "H", "insurance_form_code": "91X", "insurance_type_code": "BIPD/PRIMARY", "insurance_carrier": "GREENWICH INSURANCE COMPANY", "policy_number": "RAD9437950", "effective_date": "2020-02-01", "cancel_method": "CANCELLED", "cancel_effective_date": "2020-03-11", "underlying_limit_amount": "0", "minimum_coverage_amount": "1000000" } ], "insurance_cancel_count": "26", "insurance_last_canceled": "2020-03-11", "risk_factors": [ { "consecutive_authority": true, "sixty_mo_in_business": true, "revocation_last_thirtysix_mo": false, "indicator_network_graph_phone": true, "indicator_network_graph_address": true, "indicator_network_graph_email": false, "indicator_network_graph_ein": false, "indicator_network_graph_duns": false, "high_shared_power_units": false, "indicator_benchmark_inspected_power_units_ratio": false, "indicator_benchmark_inspection_mileage_ratio": false, "indicator_benchmark_power_unit_mileage_ratio": false, "zeo_inspections_last_twelve_mo": false, "active_usdot_status": true, "violations_severe_flag": true, "basic_alert_flag": false, "basic_ac_indicator_flag": false, "fatal_crashes_flag": true, "safety_rating_unsatisfactory_conditional": false, "secondary_contact_info_provided": true, "primary_contact_info_missing": false, "carrier_w_brokerage_authority": false, "multi_cargo_classification": false, "interstate_carrier_single_state_inspection": false, "bipd_insurance_above_minimum": false, "bipd_insurance_below_requirement": false, "cargo_insurance_on_file": false, "boc3_on_file": true, "pending_insurance_cancellation": false, "no_active_authority": false, "not_authorized_for_hire": false, "mcs150_filed_last_24_months": true, "oos_below_industry_average": false, "smartway_flag": true, "carbtru_flag": false, "phmsa_flag": false, "hazardous_material": true, "virtual_physical_mailing_address": false, "phone_number_area_codes_match_address_state": true, "stability_name_history": true, "stability_email_history": true, "stability_phone_history": true, "stability_address_history": true, "stability_contact_history": true, "stability_insurance_history": true, "dot_out_of_service": false, "driver_only_inspections": false } ], "geo_points": [ { "physical_address_zip_code": { "lat": 33.7956, "lon": -118.0648 }, "mailing_address_zip_code": { "lat": 33.7956, "lon": -118.0648 } } ], "crash_history": [ { "_id": "5105349", "changed_date": "2026-02-17T00:00:00", "report_state": "NC", "report_number": "NC0108402311", "report_date": "2026-02-13", "report_time": "1314", "report_seq_no": "1", "dot_number": "568253", "ci_status_code": "C", "final_status_date": "2026-02-17", "location": "UNION CEMETERY RD SW", "city": "CONCORD", "state": "NC", "county_code": "025", "county_name": "Cabarrus", "latitude": 35.38356666666667, "longitude": -80.56379999999999, "geo_point": { "lat": 35.38356666666667, "lon": -80.56379999999999 }, "truck_bus_ind": "T", "trafficway_id": "2", "trafficway_desc": "Two-Way Trafficway, Divided, Unprotected Median", "access_control_id": "3", "access_control_desc": "No Control", "road_surface_condition_id": "1", "road_surface_condition_desc": "Dry", "cargo_body_type_id": "8", "cargo_body_type_desc": "Auto Transporter", "gvw_rating_id": "3", "vehicle_identification_number": "5E0AA1449FG615005", "vehicle_license_number": "4NH8144", "vehicle_license_state": "CA", "vehicle_hazmat_placard": false, "weather_condition_id": "1", "weather_condition_desc": "No Adverse Conditions", "vehicle_configuration_id": "9", "vehicle_configuration_desc": "Tractor/Semitrailer", "light_condition_id": "1", "light_condition_desc": "Daylight", "hazmat_released": false, "agency": "CONCORD POLICE DEPARTMENT", "vehicles_in_accident": "2", "fatalities": "0", "injuries": "1", "tow_away": true, "federal_recordable": true, "state_recordable": true, "crash_event_seq_id_desc": "1:20:COLLISION INVOLVING OTHER MOVABLE OBJECT", "included_in_sms_flag": false }, { "_id": "5098991", "changed_date": "2026-02-06T00:00:00", "report_state": "MO", "report_number": "MO0000117243", "report_date": "2026-02-03", "report_time": "0915", "report_seq_no": "1", "dot_number": "568253", "ci_status_code": "C", "final_status_date": "2026-02-06", "location": "IS 55", "city": "HERCULANEUM", "state": "MO", "county_code": "099", "county_name": "Jefferson", "latitude": 38.296485, "longitude": -90.516085, "geo_point": { "lat": 38.296485, "lon": -90.516085 }, "truck_bus_ind": "T", "trafficway_id": "2", "trafficway_desc": "Two-Way Trafficway, Divided, Unprotected Median", "road_surface_condition_id": "1", "road_surface_condition_desc": "Dry", "cargo_body_type_id": "8", "cargo_body_type_desc": "Auto Transporter", "gvw_rating_id": "3", "vehicle_identification_number": "4V5RC9EHXTN702240", "vehicle_license_number": "V9970HY", "vehicle_license_state": "TN", "vehicle_hazmat_placard": false, "weather_condition_id": "1", "weather_condition_desc": "No Adverse Conditions", "vehicle_configuration_id": "6", "vehicle_configuration_desc": "Single-Unit Truck (3 or More Axels)", "light_condition_id": "1", "light_condition_desc": "Daylight", "hazmat_released": false, "agency": "MO0500800", "vehicles_in_accident": "2", "fatalities": "0", "injuries": "1", "tow_away": false, "federal_recordable": true, "state_recordable": true, "crash_event_seq_id_desc": "1:98:OTHER:OTHER;2:98:OTHER:OTHER;3:20:COLLISION INVOLVING OTHER MOVABLE OBJECT", "included_in_sms_flag": false } ], "crash_aggregates": [ { "_id": "20240501", "report_month": "2024-05-01", "crashes_total": "7", "crashes_total_recordable": "7", "crashes_tow_away": "4", "crash_fatalities": "1", "crash_injuries": "2", "vehicle_miles_traveled": "59459748", "total_power_units": "897", "crash_rate": 0.11772670143169797, "crash_rate_recordable": 0.11772670143169797 }, { "_id": "20080801", "report_month": "2008-08-01", "crashes_total": "1", "crashes_total_recordable": "0", "crashes_tow_away": "0", "crash_fatalities": "0", "crash_injuries": "1" } ], "inspection_history": [ { "_id": "87183650", "report_state": "TX", "report_number": "TXV262249920", "insp_date": "2026-02-26", "insp_start_time": "1350", "insp_end_time": "1407", "ci_status_code": "C", "county_code_state": "TX", "county_name": "Hidalgo", "latitude": 26.262706666666663, "longitude": -98.17788333333333, "geo_point": { "lat": 26.262706666666663, "lon": -98.17788333333333 }, "insp_level_id": "3", "insp_facility": "R", "location_desc": "US 281 NB MM 754", "hazmat_placard_req": false, "alcohol_control_sub": false, "drug_intrdctn_search": false, "drug_intrdctn_arrests": "0", "size_weight_enf": false, "traffic_enf": false, "gross_comb_veh_wt": "117000", "viol_total": "0", "oos_total": "0", "driver_viol_total": "0", "driver_oos_total": "0", "vehicle_viol_total": "0", "vehicle_oos_total": "0", "hazmat_viol_total": "0", "hazmat_oos_total": "0", "time_weight": "3", "unsafe_insp": true, "fatigued_insp": true, "dr_fitness_insp": true, "subt_alcohol_insp": true, "vh_maint_insp": false, "hm_insp": false, "vins": [ { "vin": "4V5RC9DGXGN969747", "insp_unit_id": "211927065", "insp_unit_type_id": "11", "insp_unit_type_desc": "Truck Tractor", "insp_unit_make": "VOLV", "insp_unit_license": "U4366HY", "insp_unit_license_state": "TN", "insp_unit_company": "1119" }, { "vin": "5E0AA1441HG856804", "insp_unit_id": "211927066", "insp_unit_type_id": "9", "insp_unit_type_desc": "Semi Trailer", "insp_unit_make": "COTT", "insp_unit_license": "4PJ1645", "insp_unit_license_state": "CA", "insp_unit_company": "1119T" } ], "violations": [], "included_in_sms_flag": false }, { "_id": "87160987", "report_state": "TN", "report_number": "TNI039583075", "insp_date": "2026-02-26", "insp_start_time": "0341", "insp_end_time": "0414", "ci_status_code": "C", "county_code_state": "TN", "county_name": "Giles", "latitude": 35.139362500000004, "longitude": -87.002225, "geo_point": { "lat": 35.139362500000004, "lon": -87.002225 }, "insp_level_id": "1", "insp_facility": "F", "location_desc": "ARDMORE TN", "hazmat_placard_req": false, "alcohol_control_sub": false, "drug_intrdctn_search": false, "drug_intrdctn_arrests": "0", "size_weight_enf": false, "traffic_enf": false, "gross_comb_veh_wt": "99600", "viol_total": "1", "oos_total": "1", "driver_viol_total": "0", "driver_oos_total": "0", "vehicle_viol_total": "1", "vehicle_oos_total": "1", "hazmat_viol_total": "0", "hazmat_oos_total": "0", "time_weight": "3", "unsafe_insp": true, "fatigued_insp": true, "dr_fitness_insp": true, "subt_alcohol_insp": true, "vh_maint_insp": true, "hm_insp": false, "vins": [ { "vin": "4V5RC9EH3HN970375", "insp_unit_id": "211875418", "insp_unit_type_id": "10", "insp_unit_type_desc": "Straight Truck", "insp_unit_make": "VOLVO", "insp_unit_license": "U4367HY", "insp_unit_license_state": "TN", "insp_unit_company": "1180" }, { "vin": "5E0AC1448HG950205", "insp_unit_id": "211875419", "insp_unit_type_id": "9", "insp_unit_type_desc": "Semi Trailer", "insp_unit_make": "COTTRELL T", "insp_unit_license": "4T1745", "insp_unit_license_state": "CA", "insp_unit_company": "1180T" } ], "violations": [ { "_id": "272085359", "report_number": "TNI039583075", "report_state": "TN", "insp_date": "2026-02-26", "change_date": "2026-02-27", "inspection_id": "87160987", "violation_id": "272085359", "viol_code": "39375A3TAOL", "part_no": "393", "part_no_section": "75A3-TAOL", "seq_no": "1", "basic_group_id": "1", "basic_group_desc": "Vehicle Maintenance", "viol_group_id": "62", "viol_group_desc": "Tires", "viol_desc": "Tires - All others, leaking or inflation less than 50% of the maximum inflation pressure on tire not equipped with ATIS", "viol_category_id": "23", "viol_category_desc": "Tires", "viol_type": "VEHICLE", "viol_unit_id": "1", "viol_unit_desc": "Vehicle Primary Unit", "insp_unit_id": "211875418", "oos_indicator": true, "defect_verification_id": "99", "defect_verification_desc": "Unknown", "citation_number": "WARN", "oos_weight": "2", "severity_weight": "8", "time_weight": "3", "total_severity_weight": "30", "included_in_sms_flag": false } ], "included_in_sms_flag": false } ], "basic_history": [ { "inspections_total": "659", "inspections_vehicle": "303", "inspections_vehicle_out_of_service": "77", "inspections_driver": "658", "inspections_driver_out_of_service": "5", "inspections_w_violations_unsafe_driving": "83", "basic_measure_unsafe_driving": 0.84, "basic_ac_indicator_unsafe_driving": false, "inspections_w_violations_hours_of_service": "13", "basic_measure_hours_of_service": 0.1, "basic_ac_indicator_hours_of_service": false, "inspections_w_violations_driver_fitness": "5", "basic_measure_driver_fitness": 0.09, "basic_ac_indicator_driver_fitness": false, "inspections_w_violations_controlled_substance": "0", "basic_measure_controlled_substance": 0, "basic_ac_indicator_controlled_substance": false, "inspections_w_violations_vehicle_maintence": "147", "basic_measure_vehicle_maintence": 4.01, "basic_ac_indicator_vehicle_maintence": false, "snapshot_date": "2025-10-31" }, { "inspections_total": "667", "inspections_vehicle": "304", "inspections_vehicle_out_of_service": "77", "inspections_driver": "666", "inspections_driver_out_of_service": "5", "inspections_w_violations_unsafe_driving": "84", "basic_measure_unsafe_driving": 0.82, "basic_ac_indicator_unsafe_driving": false, "inspections_w_violations_hours_of_service": "12", "basic_measure_hours_of_service": 0.1, "basic_ac_indicator_hours_of_service": false, "inspections_w_violations_driver_fitness": "5", "basic_measure_driver_fitness": 0.09, "basic_ac_indicator_driver_fitness": false, "inspections_w_violations_controlled_substance": "0", "basic_measure_controlled_substance": 0, "basic_ac_indicator_controlled_substance": false, "inspections_w_violations_vehicle_maintence": "146", "basic_measure_vehicle_maintence": 3.84, "basic_ac_indicator_vehicle_maintence": false, "snapshot_date": "2025-11-30" } ], "doc_id": "568253-MC277621" } ], "total_count": 1 } } } }, "400": { "description": "Bad request — missing or invalid parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Payment required — this key isn't linked to an active billing account. Activate live access in the developer dashboard.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden — the key is suspended (billing issue) or this operation isn't permitted for it (e.g. sandbox keys are read-only for monitoring writes; view_all is unavailable to developer keys).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "405": { "description": "Method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Rate limit exceeded — too many requests this minute (and, for monitoring, a monthly abuse cap). Back off and honor the Retry-After header (seconds).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "dot_number", "in": "query", "required": false, "description": "The USDOT number assigned to the motor carrier by FMCSA.", "schema": { "type": "string" }, "example": "568253" }, { "name": "page", "in": "query", "required": false, "description": "Page number of the result set to retrieve. The default value is set to 1.", "schema": { "type": "integer", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "description": "The number of profile ids returned per page. The default value is set to 100.", "schema": { "type": "integer", "default": 100 } }, { "name": "docket_number", "in": "query", "required": false, "description": "The MC or MX docket number (e.g., 277621 or MC277621).", "schema": { "type": "string" }, "example": "277621" }, { "name": "company", "in": "query", "required": false, "description": "Company name to search for. Supports partial matches.", "schema": { "type": "string" }, "example": "Cheetah" }, { "name": "ein", "in": "query", "required": false, "description": "9-digit Employer Identification Number.", "schema": { "type": "string" }, "example": "954485461" }, { "name": "email", "in": "query", "required": false, "description": "Email address or domain to search.", "schema": { "type": "string" }, "example": "compliance@landstar.com" }, { "name": "address", "in": "query", "required": false, "description": "Physical address to search.", "schema": { "type": "string" }, "example": "3552 GREEN AVENUE" }, { "name": "phone", "in": "query", "required": false, "description": "Phone number to search (digits only or formatted).", "schema": { "type": "string" }, "example": "5624304100" }, { "name": "vin", "in": "query", "required": false, "description": "17-character Vehicle Identification Number.", "schema": { "type": "string" }, "example": "3C7WRTCLXNG338793" }, { "name": "plate_number", "in": "query", "required": false, "description": "License plate number.", "schema": { "type": "string" }, "example": "3354005" }, { "name": "plate_state", "in": "query", "required": false, "description": "Two-letter state code to narrow plate search.", "schema": { "type": "string" }, "example": "MO" }, { "name": "unit_number", "in": "query", "required": false, "description": "Fleet unit number.", "schema": { "type": "string" }, "example": "1234" }, { "name": "unit_type", "in": "query", "required": false, "description": "TRUCK or TRAILER filter.", "schema": { "type": "string" }, "example": "TRUCK" } ], "x-carrierok-variants": [ { "slug": "dot", "title": "DOT", "summary": "Look up a carrier by USDOT number", "example_url": "https://api.carrierok.com/v2/profile?dot_number=568253", "primary_param": "dot_number" }, { "slug": "docket-number", "title": "Docket Number", "summary": "Look up a carrier by MC or MX docket number", "example_url": "https://api.carrierok.com/v2/profile?docket_number=277621", "primary_param": "docket_number" }, { "slug": "company", "title": "Company", "summary": "Search carriers by company name", "example_url": "https://api.carrierok.com/v2/profile?company=Cheetah", "primary_param": "company" }, { "slug": "ein", "title": "EIN", "summary": "Look up a carrier by Employer Identification Number", "example_url": "https://api.carrierok.com/v2/profile?ein=954485461", "primary_param": "ein" }, { "slug": "email", "title": "Email", "summary": "Search carriers by email address or domain", "example_url": "https://api.carrierok.com/v2/profile?email=compliance@landstar.com", "primary_param": "email" }, { "slug": "address", "title": "Address", "summary": "Search carriers by physical address", "example_url": "https://api.carrierok.com/v2/profile?address=3552+GREEN+AVENUE", "primary_param": "address" }, { "slug": "phone", "title": "Phone", "summary": "Search carriers by phone number", "example_url": "https://api.carrierok.com/v2/profile?phone=5624304100", "primary_param": "phone" }, { "slug": "vin", "title": "VIN", "summary": "Look up carriers associated with a Vehicle Identification Number", "example_url": "https://api.carrierok.com/v2/profile?vin=3C7WRTCLXNG338793", "primary_param": "vin" }, { "slug": "plate", "title": "Plate", "summary": "Look up carriers associated with a license plate number", "example_url": "https://api.carrierok.com/v2/profile?plate_number=3354005", "primary_param": "plate_number" }, { "slug": "unit-number", "title": "Unit Number", "summary": "Look up carriers associated with a fleet unit number", "example_url": "https://api.carrierok.com/v2/profile?unit_number=1234", "primary_param": "unit_number" } ] } }, "/v2/profile-lite": { "get": { "operationId": "getV2ProfileLite", "tags": [ "Profiles" ], "summary": "Lightweight carrier lookup", "description": "Returns a reduced field set optimized for high-volume integrations, browser extensions, and quick lookups. Same search parameters as /v2/profile. Billed per unique DOT number per calendar month.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProfileSearchResponse" }, "example": { "items": [ { "dot_number": "568253", "legal_name": "HANSEN & ADKINS AUTO TRANSPORT INC", "usdot_status": "Active", "authority_common": "Active", "physical_address_state": "CA", "total_power_units": "897" } ], "total_count": 1 } } } }, "400": { "description": "Bad request — missing or invalid parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Payment required — this key isn't linked to an active billing account. Activate live access in the developer dashboard.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden — the key is suspended (billing issue) or this operation isn't permitted for it (e.g. sandbox keys are read-only for monitoring writes; view_all is unavailable to developer keys).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "405": { "description": "Method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Rate limit exceeded — too many requests this minute (and, for monitoring, a monthly abuse cap). Back off and honor the Retry-After header (seconds).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "dot_number", "in": "query", "required": false, "description": "USDOT number", "schema": { "type": "string" } }, { "name": "docket_number", "in": "query", "required": false, "description": "MC or MX docket number", "schema": { "type": "string" } }, { "name": "company", "in": "query", "required": false, "description": "Company name (partial match)", "schema": { "type": "string" } }, { "name": "ein", "in": "query", "required": false, "description": "Employer Identification Number", "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": false, "description": "Contact email address", "schema": { "type": "string" } }, { "name": "phone", "in": "query", "required": false, "description": "Phone number", "schema": { "type": "string" } }, { "name": "address", "in": "query", "required": false, "description": "Physical address", "schema": { "type": "string" } }, { "name": "vin", "in": "query", "required": false, "description": "Vehicle Identification Number", "schema": { "type": "string" } }, { "name": "plate_number", "in": "query", "required": false, "description": "License plate number", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Page number of the result set to retrieve. The default value is set to 1.", "schema": { "type": "integer", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "description": "The number of profile ids returned per page. The default value is set to 100.", "schema": { "type": "integer", "default": 100 } } ], "x-carrierok-slug": "profile-lite", "x-carrierok-title": "Profiles Lite", "x-carrierok-example_url": "https://api.carrierok.com/v2/profile-lite?dot_number=568253" } }, "/v2/autocomplete": { "get": { "operationId": "getV2Autocomplete", "tags": [ "Profiles" ], "summary": "Carrier typeahead search", "description": "Lightweight prefix search returning minimal carrier identity for typeahead interfaces. Minimum query length of 2 characters. Results are cached for 5 minutes.", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AutocompleteSuggestion" } }, "example": [ { "dot_number": "568253", "legal_name": "HANSEN & ADKINS AUTO TRANSPORT INC", "dba": null, "city": "LOS ALAMITOS", "state": "CA" } ] } } }, "400": { "description": "Bad request — missing or invalid parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Payment required — this key isn't linked to an active billing account. Activate live access in the developer dashboard.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden — the key is suspended (billing issue) or this operation isn't permitted for it (e.g. sandbox keys are read-only for monitoring writes; view_all is unavailable to developer keys).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "405": { "description": "Method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Rate limit exceeded — too many requests this minute (and, for monitoring, a monthly abuse cap). Back off and honor the Retry-After header (seconds).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "q", "in": "query", "required": true, "description": "Search query (minimum 2 characters).", "schema": { "type": "string" }, "example": "hansen" }, { "name": "limit", "in": "query", "required": false, "description": "Maximum number of results (max: 15).", "schema": { "type": "integer", "default": 8 } } ], "x-carrierok-slug": "autocomplete", "x-carrierok-title": "Autocomplete", "x-carrierok-example_url": "https://api.carrierok.com/v2/autocomplete?q=hansen" } }, "/v2/monitoring/add": { "post": { "operationId": "postV2MonitoringAdd", "tags": [ "Monitoring" ], "summary": "Add carriers to monitoring", "description": "Add carrier profiles to the monitoring watchlist. Each unique monitored DOT is billed once per calendar month; removing mid-month does not refund, and re-adding the same DOT within the month is free (idempotent). A single request can carry your whole network — profiles are committed in chunks, so the response returns 200 once committed, or 207 if some chunks failed (retry the remainder).", "responses": { "200": { "description": "Carriers added to the watchlist", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitoringWriteResponse" }, "example": { "status": "Profiles added or updated successfully", "added": 3 } } } }, "207": { "description": "Partial commit — some chunks failed; committed profiles are billed. Retry the remainder.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitoringWriteResponse" }, "example": { "status": "Profiles added or updated successfully", "added": 2, "error": "Some profiles failed to add; committed profiles are billed. Retry the remainder." } } } }, "400": { "description": "Bad request — missing or invalid parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Payment required — this key isn't linked to an active billing account. Activate live access in the developer dashboard.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden — the key is suspended (billing issue) or this operation isn't permitted for it (e.g. sandbox keys are read-only for monitoring writes; view_all is unavailable to developer keys).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "405": { "description": "Method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Rate limit exceeded — too many requests this minute (and, for monitoring, a monthly abuse cap). Back off and honor the Retry-After header (seconds).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile_ids": { "type": "array", "items": { "type": "string" }, "description": "Array of carrier profile IDs to monitor, formatted {dot}-{docket} (e.g. 568253-MC277621)." } }, "required": [ "profile_ids" ] } } } } } }, "/v2/monitoring/remove": { "post": { "operationId": "postV2MonitoringRemove", "tags": [ "Monitoring" ], "summary": "Remove carriers from monitoring", "description": "Remove carrier profiles from the monitoring watchlist. Removal is free and does not refund the current month's billing — un-monitoring simply stops future months from billing that DOT. Large operations are committed in chunks (200 once committed, 207 if some chunks failed).", "responses": { "200": { "description": "Carriers removed from the watchlist", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitoringWriteResponse" }, "example": { "status": "Profiles removed successfully", "removed": 2 } } } }, "207": { "description": "Partial commit — some chunks failed. Retry the remainder.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitoringWriteResponse" }, "example": { "status": "Profiles removed successfully", "removed": 1, "error": "Some profiles failed to remove; retry the remainder." } } } }, "400": { "description": "Bad request — missing or invalid parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Payment required — this key isn't linked to an active billing account. Activate live access in the developer dashboard.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden — the key is suspended (billing issue) or this operation isn't permitted for it (e.g. sandbox keys are read-only for monitoring writes; view_all is unavailable to developer keys).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "405": { "description": "Method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Rate limit exceeded — too many requests this minute (and, for monitoring, a monthly abuse cap). Back off and honor the Retry-After header (seconds).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile_ids": { "type": "array", "items": { "type": "string" }, "description": "Array of carrier profile IDs to remove, formatted {dot}-{docket} (e.g. 568253-MC277621)." } }, "required": [ "profile_ids" ] } } } } } }, "/v2/monitoring/list": { "get": { "operationId": "getV2MonitoringList", "tags": [ "Monitoring" ], "summary": "List monitored carriers with change tracking", "description": "Returns a paginated list of monitored carriers with optional filtering by change type (insurance, authority, safety, fleet, contact, risk), date range, and sort order. Supports granular change visibility flags.", "responses": { "200": { "description": "Monitored carriers with change tracking", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitoringListResponse" }, "example": { "total_count": 1, "items": { "568253-MC277621": [ { "safety_rating_desc_current": "Satisfactory", "safety_rating_desc_prior": "Conditional", "safety_rating_desc_changed": true, "insurance_bipd_on_file_current": 1000000, "insurance_bipd_on_file_prior": 750000, "insurance_bipd_on_file_changed": true } ] } } } } }, "400": { "description": "Bad request — missing or invalid parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Payment required — this key isn't linked to an active billing account. Activate live access in the developer dashboard.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden — the key is suspended (billing issue) or this operation isn't permitted for it (e.g. sandbox keys are read-only for monitoring writes; view_all is unavailable to developer keys).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "405": { "description": "Method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Rate limit exceeded — too many requests this minute (and, for monitoring, a monthly abuse cap). Back off and honor the Retry-After header (seconds).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "500": { "description": "Server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "page", "in": "query", "required": false, "description": "Page number", "schema": { "type": "integer", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "description": "Results per page (clamped to 500 max)", "schema": { "type": "integer", "default": 100 } }, { "name": "view_changes", "in": "query", "required": false, "description": "Filter to profiles with any changes", "schema": { "type": "boolean" } }, { "name": "view_changes_insurance", "in": "query", "required": false, "description": "Filter to insurance changes", "schema": { "type": "boolean" } }, { "name": "view_changes_authority", "in": "query", "required": false, "description": "Filter to authority changes", "schema": { "type": "boolean" } }, { "name": "view_changes_safety", "in": "query", "required": false, "description": "Filter to safety changes", "schema": { "type": "boolean" } }, { "name": "view_changes_fleet", "in": "query", "required": false, "description": "Filter to fleet changes", "schema": { "type": "boolean" } }, { "name": "view_changes_contact", "in": "query", "required": false, "description": "Filter to contact changes", "schema": { "type": "boolean" } }, { "name": "view_changes_risk", "in": "query", "required": false, "description": "Filter to risk factor changes", "schema": { "type": "boolean" } }, { "name": "date_type", "in": "query", "required": false, "description": "Date field to filter: last_changed_date, started_monitoring_at, last_acknowledged_at, mcs150_date_current, safety_rating_date_current, last_crash_date_current, insurance_pending_cancel_date_current", "schema": { "type": "string" } }, { "name": "date_min", "in": "query", "required": false, "description": "Minimum date (YYYYMMDD format)", "schema": { "type": "string" } }, { "name": "date_max", "in": "query", "required": false, "description": "Maximum date (YYYYMMDD format)", "schema": { "type": "string" } }, { "name": "sortBy", "in": "query", "required": false, "description": "Sort field", "schema": { "type": "string", "default": "last_changed_date" } }, { "name": "sortOrder", "in": "query", "required": false, "description": "Sort direction: asc or desc", "schema": { "type": "string", "default": "desc" } }, { "name": "profile_id", "in": "query", "required": false, "description": "Filter to a single profile", "schema": { "type": "string" } } ] } } } }