--- title: "Get Current Snapshot for Monitored Carrier" method: GET path: "/monitoring/carriers/{dotNumber}" tags: ["Carrier Hub"] --- # Get Current Snapshot for Monitored Carrier `GET /monitoring/carriers/{dotNumber}` ## Request - Base URL: `http://api.truckstop.com/carrierhub/v1` - URL: `http://api.truckstop.com/carrierhub/v1/monitoring/carriers/{dotNumber}` - Auth: HTTP bearer Returns details of a carrier based on requested DOT number and modules. ## Query parameters - `modules` ExternalModule[] ## Response `200` Carrier details for the requested DOT number and modules - ExternalCarrier: A monitored carrier, including the requested data modules on file for it. - `dotNumber` string, required: The DOT number of the monitored carrier. - `docketNumbers` string[]: An array of docket numbers associated with the monitored carrier. - `lastUpdated` string, date-time, required: The date and time when the monitored carrier was last updated. - `modules` ExternalCarrierModules: The requested modules of carrier data. A module is omitted when it was not requested via the `modules` query parameter. - `demographics` ExternalCarrierDemographics: Base schema shared by all carrier data modules. - `status` 'Ok' | 'NotFound' | 'NotEntitled' | 'Unavailable', required: The status of a carrier data module. - Ok: The module's data was retrieved successfully. - NotFound: No data is on file for this carrier/module. - NotEntitled: The caller is not authorized to access this module. - Unavailable: An error occurred while retrieving this module's data. - `lastUpdated` string, date-time, nullable, required: The date and time when this module's data was last updated. Null when status is NotFound, NotEntitled, or Unavailable, since no update time exists for the module in those cases. - `sources` ExternalSourceSystem[]: An array of source systems that populated this module's data. - `data` CarrierDemographics: Demographic and identifying information for a carrier. - `legalName` string, nullable: Legal name of the carrier - `dbaName` string, nullable: Doing business as name of the carrier - `status` string, nullable: The current status of the carrier - `physicalAddress` Address: Mailing or physical address for a carrier contact. - `street` string, nullable: The street number of the address - `city` string, nullable: The city of the address - `state` string, nullable: The State of the address - `postalCode` string, nullable: The postal code of the address - `country` string, nullable: The country of the address - `mailingAddress` Address: Mailing or physical address for a carrier contact. - `street` string, nullable: The street number of the address - `city` string, nullable: The city of the address - `state` string, nullable: The State of the address - `postalCode` string, nullable: The postal code of the address - `country` string, nullable: The country of the address - `phone` string, nullable - `fax` string, nullable - `cell` string, nullable - `emailAddress` string, nullable - `dunBradstreetNumber` string, nullable - `companyOfficer1` string, nullable - `companyOfficer2` string, nullable - `carrierOperation` 'Interstate' | 'Intrastate' | 'None', nullable: Type of carrier operation - `entityTypes` EntityType[], nullable: List of entity types associated with the carrier - `classification` string[]: Carrier classification codes - `cargoTypes` string[]: Cargo types carried by the carrier - `equipmentTypes` CarrierEquipmentTypeSummary[]: Equipment types operated by the carrier, with owned/leased breakdowns - `equipmentType` string - `owned` integer - `leased` integer - `tripLeased` integer - `driversEquipment` CarrierDriversEquipmentSummary: Driver and power unit counts reported for the carrier. - `totalDrivers` integer, nullable - `cdlEmployedDrivers` integer, nullable - `monthlyAverageLeasedDrivers` integer, nullable - `interstateDrivers` integer, nullable - `intrastateDrivers` integer, nullable - `interstateDriversWithin100Miles` integer, nullable - `intrastateDriversWithin100Miles` integer, nullable - `interstateDriversBeyond100Miles` integer, nullable - `intrastateDriversBeyond100Miles` integer, nullable - `totalPoweredUnits` integer, nullable - `totalTrucksAndTractors` integer, nullable - `fleetSizeRange` string, nullable - `mcs150Mileage` integer, nullable - `mcs150Year` integer, nullable - `mcs150Date` string, date-time, nullable - `hazmatIndicator` boolean - `outOfService` boolean - `outOfServiceIssueDate` string, date, nullable - `outOfServiceReason` string, nullable - `authority` ExternalCarrierAuthority: Base schema shared by all carrier data modules. - `status` 'Ok' | 'NotFound' | 'NotEntitled' | 'Unavailable', required: The status of a carrier data module. - Ok: The module's data was retrieved successfully. - NotFound: No data is on file for this carrier/module. - NotEntitled: The caller is not authorized to access this module. - Unavailable: An error occurred while retrieving this module's data. - `lastUpdated` string, date-time, nullable, required: The date and time when this module's data was last updated. Null when status is NotFound, NotEntitled, or Unavailable, since no update time exists for the module in those cases. - `sources` ExternalSourceSystem[]: An array of source systems that populated this module's data. - `data` CarrierAuthorities: Operating authority information for a carrier. A carrier may hold multiple authorities, one per docket number. - `authorities` CarrierAuthorityRecord[]: Individual operating authorities held by the carrier - `docketNumber` string, nullable - `isBroker` boolean - `authorityAgeDays` integer, nullable - `bipdRequired` integer, nullable - `bipdOnFile` integer, nullable - `cargoRequired` boolean, nullable - `cargoOnFile` boolean, nullable - `bondSuretyRequired` boolean, nullable - `bondSuretyOnFile` boolean, nullable - `property` boolean, nullable - `passenger` boolean, nullable - `householdGoods` boolean, nullable - `private` boolean, nullable - `enterprise` boolean, nullable - `pendingCommonAuthorityRevocation` boolean, nullable - `pendingContractAuthorityRevocation` boolean, nullable - `pendingBrokerAuthorityRevocation` boolean, nullable - `grants` CarrierAuthorityGrant[]: Individual authority grants held under this authority - `authorityType` string, nullable - `authorityCategory` string, nullable - `authorityStatus` string, nullable - `originalAction` string, nullable - `lastAction` string, nullable - `originalGrantDate` string, date, nullable - `lastGrantDate` string, date, nullable - `appPending` boolean - `pendingAuthorityRevocation` boolean - `revoked` boolean - `lastRevocationDate` string, date, nullable - `authorityAgeDays` integer - `insurance` ExternalCarrierInsurance: Base schema shared by all carrier data modules. - `status` 'Ok' | 'NotFound' | 'NotEntitled' | 'Unavailable', required: The status of a carrier data module. - Ok: The module's data was retrieved successfully. - NotFound: No data is on file for this carrier/module. - NotEntitled: The caller is not authorized to access this module. - Unavailable: An error occurred while retrieving this module's data. - `lastUpdated` string, date-time, nullable, required: The date and time when this module's data was last updated. Null when status is NotFound, NotEntitled, or Unavailable, since no update time exists for the module in those cases. - `sources` ExternalSourceSystem[]: An array of source systems that populated this module's data. - `data` CarrierInsurance: Insurance coverage information for a carrier, from both FMCSA-filed policies and Truckstop-managed insurance certificates. - `fmcsaInsurance` CarrierFmcsaInsurance: FMCSA-filed insurance information for a carrier. - `policies` CarrierInsurancePolicy[]: FMCSA-filed insurance policies on file for the carrier - `underwriter` string, nullable - `policyNumber` string, nullable - `coverageType` string, nullable - `coverageAmount` number, nullable - `effectiveDate` string, date, nullable - `postedDate` string, date, nullable - `cancellationDate` string, date, nullable - `managedInsurance` CarrierManagedInsurance: Truckstop-managed insurance information for a carrier. - `certificates` CarrierInsuranceCertificate[]: Truckstop-managed insurance certificates on file for the carrier - `certificateId` integer - `mcNumber` string, nullable - `producerName` string - `producerEmail` string, nullable - `producerPhone` string, nullable - `producerFax` string, nullable - `producerAddress` Address: Mailing or physical address for a carrier contact. - … - `coverages` CarrierInsuranceCoverage[]: Individual coverages on this certificate - … - `equipment` CarrierInsuranceEquipment[]: Equipment scheduled on this certificate - … - `safety` ExternalCarrierSafety: Base schema shared by all carrier data modules. - `status` 'Ok' | 'NotFound' | 'NotEntitled' | 'Unavailable', required: The status of a carrier data module. - Ok: The module's data was retrieved successfully. - NotFound: No data is on file for this carrier/module. - NotEntitled: The caller is not authorized to access this module. - Unavailable: An error occurred while retrieving this module's data. - `lastUpdated` string, date-time, nullable, required: The date and time when this module's data was last updated. Null when status is NotFound, NotEntitled, or Unavailable, since no update time exists for the module in those cases. - `sources` ExternalSourceSystem[]: An array of source systems that populated this module's data. - `data` CarrierSafety: Safety rating, crash, and inspection information for a carrier. - `generalSafetyRating` string, nullable - `generalSafetyRatingDate` string, date, nullable - `safetyRating` string, nullable - `safetyRatingDate` string, date, nullable - `reviewType` string, nullable - `reviewDate` string, date, nullable - `basedInCity` string, nullable - `basedInState` string, nullable - `totalCrashes` integer - `fatalCrashes` integer - `injuryCrashes` integer - `towCrashes` integer - `inspections` CarrierInspectionsSummary: Aggregate inspection and out-of-service statistics for a carrier. - `totalInspections` integer - `vehicleInspections` integer - `driverInspections` integer - `violationCount` integer - `lastInspectionDate` string, date, nullable - `lastViolationDate` string, date, nullable - `vehicleOosViolations` integer - `driverOosViolations` integer - `hazmatOosViolations` integer - `vehicleOosPercentile` number, nullable - `driverOosPercentile` number, nullable - `mcs150PowerUnits` integer, nullable - `inspectedVehicleCount` integer, nullable - `inspectedVehiclePercentage` number, nullable - `inspectedStateCount` integer - `thresholdAlertCount` integer - `csaInspectionTotal` integer - `csaDriverInspectionTotal` integer - `csaDriverOosInspectionWithViolation` integer - `csaVehicleInspectionTotal` integer - `csaVehicleOosInspectionTotal` integer - `inspectionsByState` CarrierInspectionByStateSummary[]: Inspection counts broken down by state - `stateCode` string - `inspectionCount` integer - `csaBasics` CarrierCsaBasicSummary[]: CSA BASIC category measures for the carrier - `basicCategory` string, nullable - `eventGroup` string, nullable - `effectiveDate` string, date, nullable - `isHazmat` boolean, nullable - `basicValue` integer, nullable - `inspectionWithViolation` integer, nullable - `thresholdHazmat` number, nullable - `thresholdRegular` number, nullable - `measure` number, nullable - `percentile` number, nullable - `isOverThreshold` boolean, nullable - `isAdditionalConcern` boolean, nullable - `isRoadsideAlert` boolean, nullable - `isBasicAlert` boolean, nullable - `reputation` ExternalCarrierReputation: Base schema shared by all carrier data modules. - `status` 'Ok' | 'NotFound' | 'NotEntitled' | 'Unavailable', required: The status of a carrier data module. - Ok: The module's data was retrieved successfully. - NotFound: No data is on file for this carrier/module. - NotEntitled: The caller is not authorized to access this module. - Unavailable: An error occurred while retrieving this module's data. - `lastUpdated` string, date-time, nullable, required: The date and time when this module's data was last updated. Null when status is NotFound, NotEntitled, or Unavailable, since no update time exists for the module in those cases. - `sources` ExternalSourceSystem[]: An array of source systems that populated this module's data. - `data` CarrierReputation: CPR (Carrier Performance Report) reputation data for a carrier. - `score` CprScoreBase: CPR rating and broker report counts shared across CPR score views. - `cprRating` string, nullable: The CPR grade rating of the carrier. - `hasActiveReports` boolean: Whether the carrier has any good or bad reports on record. - `goodReportCountZeroToThirtyDays` integer, nullable: Good reports within 0-30 days. - `goodReportCountThirtyOneToNinetyDays` integer, nullable: Good reports within 31-90 days. - `goodReportCountNinetyOneToYear` integer, nullable: Good reports within 91-365 days. - `goodReportCountOverOneYear` integer, nullable: Good reports over one year. - `badReportCountZeroToThirtyDays` integer, nullable: Bad reports within 0-30 days. - `badReportCountThirtyOneToNinetyDays` integer, nullable: Bad reports within 31-90 days. - `badReportCountNinetyOneToYear` integer, nullable: Bad reports within 91-365 days. - `badReportCountOverOneYear` integer, nullable: Bad reports over one year. - `reports` CprReport[]: Individual CPR reports on file for the carrier - `type` 'Good' | 'Bad': Enumeration of CPR report types. - `date` string, date, nullable: date - `source` string, nullable: source - `complaint` string, nullable: source - `description` string, nullable: source ## Other responses - `400`: There was a problem with the data provided for this request. - `401`: Authorization was denied for this request. - `404`: The requested resource was not found. - `499`: The request was closed by the client before the server could respond. - `500`: A server side error occurred. --- [API](https://skmtc.dev/truckstop/apis/carrierhub.md) - [All operations](https://skmtc.dev/truckstop/apis/carrierhub/llms.txt) - [OpenAPI document](https://skmtc.dev/truckstop/apis/carrierhub/revisions/a5d988fae489?raw)