inspections

Inspections Data

When requesting a full Carrier profile, the recent_inspections field will contain up to 50 of the most-recent inspections from the past two years.

Inspections Object

This is the data that is always present with a Carrier Profile returned by our API. This type of data is updated on a monthly basis.

field	type	description
inspection_id	string	Unique identifier for the inspection
report_id	string	Unique identifier for the inspection
inspection_date	date	Date the inspection occurred
report_state	string	The state/region/province where the inspection occurred
out_of_service_total	number	The number of out of service violations associated with this inspection
is_post_accident	boolean	If true, indicates the inspection occurred post-accident
has_doa_arrest	boolean	If true, indicates the inspection resulted in at least one drug or alcohol arrest
violations	array	List of violations associated with this inspection
hazmat_oos_total	number	The number of hazmat OOS violations from this inspection
truck	object	Property Type Explanation vin string VIN Number make string Make of Vehicle model string Model of Vehicle man_id number Maufacturer ID axles number Number of Axles truck_drive string Drive Train Configuration truck_gvwr number Gross Vehicle Weight Rating
trailer	object	Property Type Explanation vin string VIN Number make string Make of Equipment/Trailer model string Trailer Model man_id number Manufacturer ID axles number Number of Axles trailer_body string Type of trailer (tanker, flatbed, etc). trailer_hitch string Type of hitch the trailer uses trailer_info string Additional Trailer Description/Info trailer_length number Length (in feet) of the trailer trailer_year number Year the trailer was manufactured

Example Inspections Data

Here is an example of the type of information that might be contained in an inspection object:

{
    "inspection_id": 123456789,
    "report_id": "NE00012345",
    "inspection_date": "2023-01-01T00:00:00.000Z",
    "report_state": "NM",
    "out_of_service_total": 0,
    "has_doa_arrest": false,
    "is_post_accident": false,
    "violations":[...],
    "hazmat_oos_total": 0,
    "truck": {
      "vin": "0123456789",
      "axles": 3,
      "make": "FREIGHTLINER",
      "model": "CASCADIA",
      "man_id": 1024,
      "truck_drive": "6 x 4",
      "truck_gvwr": 8,
    },
    "trailer": {
      "vin": "0123456789",
      "axles": 2,
      "make": "BULK TANK INTERNATIONAL",
      "model": "DOT/TC SPECIFICATION (406/407/412/331/338/ETM)",
      "man_id": 11798,
      "trailer_body": "TANK TRAILER",
      "trailer_hitch": ,
      "trailer_info": "BODY TYPE: STAINLESS STEEL, LENGTH OF TRAILER: 40-50 FEET",
      "trailer_length": 48,
      "trailer_year": 2023,
    }
}

Violations Data

Inspections can contain 0 or more violations in the violations field.

Violations Object

This is an object that contains data about a violation that was logged during an inspection. The type of each violation can be found in the federal code using the part & sequence numbers. Similar types of violations can be grouped into categories and referenced using their category id ( https://ask.fmcsa.dot.gov/euf/assets/mcmiscatalog/d_inspection6.html ). These categories can be further grouped into three kinds of violations: "Driver Violations", "Hazmat Violations", or "Vehicle Violations"

The table below describes the fields within a violation object:

Example Violation Data

Here is an example of what type of information that might be contained in a violation object:

{
  "inspection_violation_id": 987654321, 
  "sequence_number": 2,
  "part_number": 393,
  "part_number_section": "45B2",
  "inspection_violaton_unit": "2",
  "inspection_violation_category_id": 16,
  "out_of_service": true,
  "defect_verification_id": 1
}

Finding Violation Details

To find more information about what was in violation, refer to the part_number and part_number_section fields. In this example, the part number and section refer to 393.45(b)(2).

According to https://www.ecfr.gov/current/title-49/subtitle-B/chapter-III/subchapter-B/part-393/subpart-C/section-393.45 - this specific violation is refering to "Brake tubing and hose must be secured against chaffing, kinking, or other mechanical damage"

field	type	description
inspection_violation_id	string	Unique identifier for this violation
sequence_number	number	Sequence number of the violation
part_number	number	Refers to the part of the federal code this violations falls under.
part_number_section	number	Refers to the specific section (within the part) of the federal code that this violations falls under.
inspection_violation_unit	string	The unit/vehicle this violation applies to
inspection_violation_category_id	number	Similar violations in the federal code are grouped into categories. These categories can be found at https://ask.fmcsa.dot.gov/euf/assets/mcmiscatalog/d_inspection6.html
out_of_service	boolean	When true, this is an out-of-service violation. These types of violations are more critical than non-OOS violations.
defect_verification_id	number	Identifies what happened as a result of the inspection. 1=Repaired At Scene 2=Towed/Escorted to repair service 3=Non-OOS/Driver Non-OOS 4=Other 99=Unknown/Unverified