get https://api.gomotive.com/v1/hos_violations
Purpose: Use this API to pull out a list of all the driver's with Hours of Service (HOS) violations. Hours of Service or HOS is mandated by governments to reduce the driving hours of the driver, and allows the drivers to have a stress-free and fatigue-free job. Ensuring drivers adhere to HOS regulations is vital for maintaining compliance with legal and regulatory requirements. Frequent violations can lead to disruptions, such as fines or penalties, and affect operational efficiency. Tracking violations helps in managing and mitigating these disruptions.
NOTE
The Query Parameter
violation_typesallows you to filter the API response accordingly. You can use the following violation types in the query:
| Code | Definition |
|---|---|
| break_30 | 30-minute break rule; drivers must take a 30-minute break after 8 hours of driving. |
| driving_10 | Maximum of 10 hours driving time in a workday under certain regulations. |
| driving_11 | Maximum of 11 hours driving time in a workday under specific regulations. |
| duty_12 | Maximum of 12 hours on-duty time in a workday. |
| duty_14 | 14-hour on-duty limit; drivers cannot drive beyond the 14th consecutive hour after coming on duty. |
| duty_15 | 15-hour on-duty limit; under certain exceptions, drivers cannot drive beyond the 15th consecutive hour. |
| duty_16 | 16-hour short-haul exception; allows one 16-hour on-duty period once per week for certain drivers. |
| cycle_60 | 60-hour/7-day cycle limit; drivers cannot drive after 60 hours on duty in 7 consecutive days. |
| cycle_70 | 70-hour/8-day cycle limit; drivers cannot drive after 70 hours on duty in 8 consecutive days. |
| cycle_60_p | 60-hour/7-day cycle limit under specific regulations. |
| cycle_70_p | 70-hour/8-day cycle limit under specific regulations. |
| canada_driving_13 | Maximum of 13 hours driving time in a workday in Canada. |
| canada_driving_15 | Maximum of 15 hours driving time in a workday under specific regulations in Canada. |
| canada_duty_14 | 14-hour on-duty limit in a workday in Canada. |
| canada_duty_16 | 16-hour on-duty limit in a workday under specific regulations in Canada. |
| canada_duty_18 | Maximum of 18 hours on-duty time in Canada. |
| canada_duty_20 | Maximum of 20 hours on-duty time in Canada. |
| canada_daily_break_8 | 8-hour daily off-duty break required in Canada. |
| canada_daily_break_10 | 10-hour daily off-duty break required in Canada. |
| canada_daily_driving_13 | Maximum of 13 hours driving time in a day in Canada. |
| canada_daily_duty_14 | Maximum of 14 hours on-duty time in a day in Canada. |
| canada_cycle_70 | 70-hour/7-day cycle limit in Canada. |
| canada_cycle_80 | 80-hour/7-day cycle limit in Canada. |
| canada_cycle_120 | 120-hour/14-day cycle limit in Canada. |
| canada_break_24 | Required 24-hour break in Canada after certain periods of duty. |
| canada_break_24_70 | Required 24-hour break in Canada after reaching 70 hours of duty. |
| canada_break_24_80 | Required 24-hour break in Canada after reaching 80 hours of duty. |
| canada_oil_driving_13 | Maximum of 13 hours driving time under oil field operations regulations in Canada. |
| canada_oil_duty_14 | Maximum of 14 hours on-duty time under oil field operations regulations in Canada. |
| canada_oil_duty_16 | Maximum of 16 hours on-duty time under oil field operations regulations in Canada. |
| canada_oil_break_3_24 | 3-hour break required in Canada under oil field operations regulations. |
| canada_oil_daily_driving_13 | Maximum of 13 hours daily driving time under oil field operations regulations in Canada. |
| canada_oil_daily_duty_14 | Maximum of 14 hours daily on-duty time under oil field operations regulations in Canada. |
| canada_oil_daily_break_10 | 10-hour daily break required under oil field operations regulations in Canada. |
| ca_driving_12 | Maximum of 12 hours driving time in California. |
| ca_duty_16 | Maximum of 16 hours on-duty time in California. |
| ca_cycle_80 | 80-hour/8-day cycle limit in California. |
| ca_driving_10 | Maximum of 10 hours driving time in California. |
| ca_duty_15 | Maximum of 15 hours on-duty time in California. |
| ca_duty_16_p | 16-hour on-duty limit under specific California regulations. |
| ca_cycle_80_p | 80-hour/8-day cycle limit under specific California regulations. |
| tx_driving_12 | Maximum of 12 hours driving time in Texas. |
| tx_duty_15 | Maximum of 15 hours on-duty time in Texas. |
| tx_cycle_70 | 70-hour/7-day cycle limit in Texas. |
| ak_cycle_70 | 70-hour/7-day cycle limit in Alaska. |
| ak_cycle_80 | 80-hour/8-day cycle limit in Alaska. |
| ak_duty_20 | Maximum of 20 hours on-duty time in Alaska. |
| ak_driving_15 | Maximum of 15 hours driving time in Alaska. |
| ak_cycle_70_p | 70-hour/7-day cycle limit under specific Alaska regulations. |
| ak_cycle_80_p | 80-hour/8-day cycle limit under specific Alaska regulations. |
| short_haul_break_30 | 30-minute break rule for short-haul operations. |
| short_haul_driving_11 | Maximum of 11 hours driving time for short-haul operations. |
| short_haul_duty_14 | 14-hour on-duty limit for short-haul operations. |
| short_haul_duty_16 | 16-hour on-duty limit for short-haul operations under specific conditions. |
| short_haul_cycle_60 | 60-hour/7-day cycle limit for short-haul operations. |
| short_haul_cycle_70 | 70-hour/8-day cycle limit for short-haul operations. |
| short_haul_driving_10_p | Maximum of 10 hours driving time for short-haul operations under specific conditions. |
| short_haul_duty_14_p | 14-hour on-duty limit for short-haul operations under specific conditions. |
| short_haul_duty_16_p | 16-hour on-duty limit for short-haul operations under specific conditions. |
| short_haul_cycle_60_p | 60-hour/7-day cycle limit for short-haul operations under specific conditions. |
| short_haul_cycle_70_p | 70-hour/8-day cycle limit for short-haul operations under specific conditions. |
require 'uri'
require 'net/http'
url = URI('https://api.gomotive.com/v1/hos_violations')
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request['Authorization'] = "Bearer <OAUTH_TOKEN>"
response = http.request(request)
puts response.read_body
Response Parameters
hos_violations
- Type: Array of Objects
- Description: List of Hours of Service (HOS) violations.
hos_violation
-
Type: Object
-
Description: Details of the HOS violation.
id
- Type: Integer
- Description: Unique identifier for the HOS violation.
type
- Type: String
- Description: The type of HOS violation.
start_time
- Type: String
- Description: The start time of the HOS violation in ISO 8601 format.
end_time
- Type: String
- Description: The end time of the HOS violation in ISO 8601 format, if applicable.
name
- Type: String
- Description: The name or description of the HOS violation.
user
- Type: Object
- Description: Details of the driver associated with the HOS violation.
id
- Type: Integer
- Description: Unique identifier for the driver.
first_name
- Type: String
- Description: The first name of the driver.
last_name
- Type: String
- Description: The last name of the driver.
username
- Type: String
- Description: The username of the driver.
email
- Type: String
- Description: The email address of the driver.
driver_company_id
- Type: String
- Description: The ID of the driver’s company.
status
- Type: String
- Description: The status of the driver (e.g., active, deactivated).
role
- Type: String
- Description: The role of the driver (e.g., driver, admin).