- Endpoint: v1/available_time
- Description: Retrieves a list of drivers with their remaining available driving time for the day, based on Hours of Service (HOS) rules.
- Use Case: Used by dispatchers to assign trips efficiently, ensuring that only drivers with sufficient available hours are dispatched, thereby reducing the risk of HOS violations.
- Endpoint: v1/hours_of_service
- Description: Returns HOS information for all drivers, showing their current duty status, driving hours used, and hours remaining.
- Use Case: Fleet managers use this to monitor compliance with HOS regulations, ensuring drivers adhere to rest and driving periods and remain compliant with safety regulations.
- Endpoint: v1/hos_violations
- Description: Provides a list of all drivers who have violated HOS regulations, detailing the type and time of each violation.
- Use Case: This endpoint is useful for compliance officers or safety managers who need to review violations, identify trends, and implement corrective actions to improve safety and reduce fines.
- Endpoint: v1/logs
- Description: Retrieves HOS logs for all drivers, detailing duty status changes, hours worked, and breaks taken.
- Use Case: Used by fleet managers or auditors to review daily or historical HOS logs, ensuring that logs are accurate and drivers remain within regulatory limits.
- Endpoint: v2/logs
- Description: Responses for this endpoint are based on the options you enable for the inspection reports feature on your Motive dashboard mainly the Custom Defect List and the Defect Level Resolution.
- Use Case: Frequent violations can lead to disruptions, such as fines or penalties, and affect operational efficiency. Tracking violations helps in managing and mitigating these disruptions.
- Endpoint: v1/log_suggestions
- Description: Retrieves a list of suggested changes to driver logs, often based on detected discrepancies or corrections to improve log accuracy.
- Use Case: This is useful for fleet administrators reviewing suggested log changes to ensure logs accurately reflect driver activities and correct any discrepancies.
- Endpoint: v1/log_suggestions
- Description: Creates a new suggestion for modifying a driver’s HOS log, which might include adjustments to duty status or correction of errors.
- Use Case: If a driver’s log contains an error or requires adjustments due to unforeseen circumstances, Fleet Managers can use this endpoint to suggest changes, ensuring the log reflects actual driving hours accurately.
- Endpoint: v1/log_suggestions/{id}
- Description: Modifies an existing log suggestion, allowing changes to details like status, corrections, or additional notes.
- Use Case: Used when a previously suggested log adjustment needs updating, either to refine the suggestion or respond to new information, ensuring all log entries remain accurate and compliant.
