get https://api.gomotive.com/v2/logs
Purpose: Use this API to fetch a list of the HOS logs of the drivers. The Hours of Service (HOS) logs are important as part of the regulatory and compliance requirements. 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
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.
- Custom Defect List: If this option is enabled for inspection reports, then you will receive the response in the following hierarchy.
- Inspected parts
- Defects object
The defects object will be embedded inside every inspected parts array. The Defects object will contain information about the defect such as the name (title),and the severity (major or minor).
- Defect Level Resolution: If this option is enabled for inspection reports, then you will receive the response in the following hierarchy.
- Inspected parts
- Mechanic Details
- Resolver
The mechanic details object contains the
mechanic_signature_urland themechanic_signed_atparameters with values asnull. These values are present inside everyinspected_part. The status of these parts can be one of the following:
goodopenrepairedno_repair_neededThe mechanic details are present inside the resolver object.
For defect level resolution, the external_resolver_id, serves as a unique identifier for the resolver of your system. This ID will be sent back to Motive in the public API, but will not be visible on the dashboard.
{
"logs": [
{
"log": {
"id": 47,
"date": "2016-11-22",
"total_miles": 300,
"metric_units": false,
"driver_signed_at": "2016-07-16T00:05:21Z",
"driver_signature_url": "https://keep-truckin-development.s3.amazonaws.com/uploads/log/driver_signature_upload/47/open-uri20160729-30633-1jeoj77?AWSAccessKeyId=AKIAJHHsdfsTJMZBMLQ&Expires=1485085850&Signature=YXqKF9nyfJI%2qEEq3obOLlFzsuKs0%3D",
"time_zone": "Pacific Time (US & Canada)",
"cycle": "70_8",
"driver_first_name": "Demo",
"driver_last_name": "Driver",
"carrier_name": "Demo Carrier",
"carrier_street": "415 Truckin St.",
"carrier_city": "San Francisco",
"carrier_state": "CA",
"carrier_zip": "94105",
"terminal_street": null,
"terminal_city": null,
"terminal_state": null,
"terminal_zip": null,
"notes": null,
"driver_company_id": null,
"origin": null,
"destination": null,
"exception_24_hour_restart": false,
"exception_8_hour_break": false,
"exception_wait_time": false,
"exception_short_haul": false,
"short_haul": false,
"eld_mode": "logs",
"co_driver_full_names": [
],
"odometers": {
},
"trailer_numbers": "17",
"vehicle_numbers": "12345, 12",
"off_duty_duration": 43200,
"on_duty_duration": 7200,
"sleeper_duration": 0,
"driving_duration": 21600,
"waiting_duration": 0,
"driver": {
"id": 11,
"first_name": "Demo",
"last_name": "Driver",
"username": "demo_driver",
"email": null,
"driver_company_id": null,
"status": "active",
"role": "driver"
},
"vehicles": [
{
"vehicle": {
"id": 11,
"number": "12345",
"year": null,
"make": null,
"model": null,
"vin": null,
"metric_units": true
}
}
],
"co_drivers": [
{
"co_driver": {
"id": 33,
"first_name": "John",
"last_name": "Doe",
"username": "johndoe",
"email": "[email protected]",
"driver_company_id": null,
"status": "active",
"role": "driver"
}
}
],
"remarks": [
{
"remark": {
"id": 1,
"time": "2016-10-16T23:59:59Z",
"notes": null,
"location": null
}
}
],
"cycle_restarts": [
{
"cycle_restart": {
"id": 1,
"start_time": "2016-10-16T08:00:00Z",
"end_time": "2016-10-17T05:00:00Z",
"type": "34_hour",
"name": "34 Hour"
}
}
],
"shipping_docs": "123ABC",
"form_and_manner_errors": [
],
"hos_violations": [
{
"hos_violation": {
"id": 12,
"type": "canada_driving_13",
"name": "13 Hour Driving Limit",
"start_time": "2016-10-16T08:00:00Z",
"end_time": "2016-10-17T07:00:00Z"
}
}
],
"events": [
{
"event": {
"id": 221,
"type": "driving",
"notes": null,
"location": "Mobile, AL",
"start_time": "2016-10-16T07:00:00Z",
"end_time": "2016-10-16T09:00:00Z",
"is_manual": false
}
},
{
"event": {
"id": 474,
"type": "sleeper",
"notes": null,
"location": null,
"start_time": "2016-10-16T09:00:00Z",
"end_time": "2016-10-16T11:00:00Z",
"is_manual": false
}
},
{
"event": {
"id": 475,
"type": "driving",
"notes": null,
"location": null,
"start_time": "2016-10-16T11:00:00Z",
"end_time": "2016-10-17T07:00:00Z",
"is_manual": false
}
}
],
"inspection_reports": [
{
"inspection_report": {
"id": 9,
"log_id": 47,
"date": "2016-07-22",
"time": "2016-07-22T14:00:00Z",
"odometer": 253,
"carrier_name": "Demo Carrier",
"location": "Omaha, NE",
"status": "corrected",
"mechanic_signed_at": "2016-07-22T14:00:00Z",
"mechanic_signature_url": "https://keep-truckin-development.s3.amazonaws.com/uploads/inspection_report/mechanic_signature_upload/9/open-uri20160712-30633-thc30n?AWSAccessKeyId=AKIAJH12345&Expires=1481274629&Signature=Qi1mXnl0ylJ5tCuds789Ocq44L4%3D",
"driver_signed_at": "2016-07-22T14:00:00Z",
"driver_signature_url": "https://keep-truckin-development.s3.amazonaws.com/uploads/inspection_report/driver_signature_upload/9/open-uri20160729-30645-1jeoj77?AWSAccessKeyId=AKIAJH12345&Expires=1481274629&Signature=Qi1mXnl0ylJ5tCuds789Ocq44L4%3D",
"reviewer_signed_at": "2016-07-22T14:00:00Z",
"reviewer_signature_url": "https://keep-truckin-development.s3.amazonaws.com/uploads/inspection_report/reviewer_signature_upload/9/open-uri20160729-30645-1jeoj77?AWSAccessKeyId=AKIAJH12345&Expires=1481274629&Signature=Qi1mXnl0ylJ5tCuds789Ocq44L4%3D",
"entity_num": "entity_num",
"entity_type": "vehicle",
"is_rejected": false,
"inspection_type": "pre-trip",
"declaration": "I declare that this vehicle has been inspected in accordance with the applicable requirements.",
"inspected_parts": [
{
"id": 5,
"category": "Brakes",
"notes": "notes",
"type": "major",
"picture_url": "https://keep-truckin-preview.s3.amazonaws.com/uploads/defect/picture_upload/23137/15c31555-6642-4215-a3cd-81def1d329012396939324379336808.jpg?X"
}
],
"not_inspected_parts": [
{
"category": "9 - Emergency Equipment & Safety Devices"
},
{
"category": "15 - Heater/Defroster"
}
],
"vehicle": {
"id": 4,
"number": "Demo Vehicle",
"year": "2016",
"make": "Demo",
"model": "Vehicle",
"vin": "WP0AB2966NS458669",
"metric_units": false
},
"asset": {
"id": 101,
"make": "Toyota",
"metric_units": true,
"model": "Camry",
"name": "V123",
"year": 2022
},
"mechanic": {
"id": 12,
"first_name": "Joe",
"last_name": "Williams",
"username": null,
"email": "[email protected]",
"driver_company_id": "123",
"mcleod_id": null,
"status": "active",
"role": "driver"
},
"driver": {
"id": 11,
"first_name": "Demo",
"last_name": "Driver",
"username": "demo_driver",
"email": null,
"driver_company_id": "123",
"mcleod_id": null,
"status": "active",
"role": "driver"
},
"reviewer": {
"id": 13,
"first_name": "John",
"last_name": "Williams",
"username": null,
"email": "[email protected]",
"driver_company_id": "123",
"mcleod_id": null,
"status": "active",
"role": "driver"
},
"external_ids": [
{
"external_id": "201",
"integration_name": "generic_tms"
},
{
"external_id": "Truck123",
"integration_name": "generic_maintenance_system"
}
],
"entries": [
{
"name": "Tractor Plate #",
"value": "2743186",
"position": 1
},
{
"name": "Trailer Plate #",
"value": "T473278",
"position": 2
}
]
}
}
]
}
}
],
"pagination": {
"per_page": 25,
"page_no": 1,
"total": 1
}
}
{
"logs": [
{
"log": {
"id": 47,
"date": "2016-11-22",
"total_miles": 300,
"metric_units": false,
"driver_signed_at": "2016-07-16T00:05:21Z",
"driver_signature_url": "https://keep-truckin-development.s3.amazonaws.com/uploads/log/driver_signature_upload/47/open-uri20160729-30633-1jeoj77?AWSAccessKeyId=AKIAJHHsdfsTJMZBMLQ&Expires=1485085850&Signature=YXqKF9nyfJI%2qEEq3obOLlFzsuKs0%3D",
"time_zone": "Pacific Time (US & Canada)",
"cycle": "70_8",
"driver_first_name": "Demo",
"driver_last_name": "Driver",
"carrier_name": "Demo Carrier",
"carrier_street": "415 Truckin St.",
"carrier_city": "San Francisco",
"carrier_state": "CA",
"carrier_zip": "94105",
"terminal_street": null,
"terminal_city": null,
"terminal_state": null,
"terminal_zip": null,
"notes": null,
"driver_company_id": null,
"origin": null,
"destination": null,
"exception_24_hour_restart": false,
"exception_8_hour_break": false,
"exception_wait_time": false,
"exception_short_haul": false,
"short_haul": false,
"eld_mode": "logs",
"co_driver_full_names": [
],
"odometers": {
},
"trailer_numbers": "17",
"vehicle_numbers": "12345, 12",
"off_duty_duration": 43200,
"on_duty_duration": 7200,
"sleeper_duration": 0,
"driving_duration": 21600,
"waiting_duration": 0,
"driver": {
"id": 11,
"first_name": "Demo",
"last_name": "Driver",
"username": "demo_driver",
"email": null,
"driver_company_id": null,
"status": "active",
"role": "driver"
},
"vehicles": [
{
"vehicle": {
"id": 11,
"number": "12345",
"year": null,
"make": null,
"model": null,
"vin": null,
"metric_units": true
}
}
],
"co_drivers": [
{
"co_driver": {
"id": 33,
"first_name": "John",
"last_name": "Doe",
"username": "johndoe",
"email": "[email protected]",
"driver_company_id": null,
"status": "active",
"role": "driver"
}
}
],
"remarks": [
{
"remark": {
"id": 1,
"time": "2016-10-16T23:59:59Z",
"notes": null,
"location": null
}
}
],
"cycle_restarts": [
{
"cycle_restart": {
"id": 1,
"start_time": "2016-10-16T08:00:00Z",
"end_time": "2016-10-17T05:00:00Z",
"type": "34_hour",
"name": "34 Hour"
}
}
],
"shipping_docs": "123ABC",
"form_and_manner_errors": [
],
"hos_violations": [
{
"hos_violation": {
"id": 12,
"type": "canada_driving_13",
"name": "13 Hour Driving Limit",
"start_time": "2016-10-16T08:00:00Z",
"end_time": "2016-10-17T07:00:00Z"
}
}
],
"events": [
{
"event": {
"id": 221,
"type": "driving",
"notes": null,
"location": "Mobile, AL",
"start_time": "2016-10-16T07:00:00Z",
"end_time": "2016-10-16T09:00:00Z",
"is_manual": false
}
},
{
"event": {
"id": 474,
"type": "sleeper",
"notes": null,
"location": null,
"start_time": "2016-10-16T09:00:00Z",
"end_time": "2016-10-16T11:00:00Z",
"is_manual": false
}
},
{
"event": {
"id": 475,
"type": "driving",
"notes": null,
"location": null,
"start_time": "2016-10-16T11:00:00Z",
"end_time": "2016-10-17T07:00:00Z",
"is_manual": false
}
}
],
"inspection_reports": [
{
"inspection_report": {
"id": 9,
"log_id": 47,
"date": "2016-07-22",
"time": "2016-07-22T14:00:00Z",
"odometer": 253,
"carrier_name": "Demo Carrier",
"location": "Omaha, NE",
"status": "corrected",
"mechanic_signed_at": "2016-07-22T14:00:00Z",
"mechanic_signature_url": "https://keep-truckin-development.s3.amazonaws.com/uploads/inspection_report/mechanic_signature_upload/9/open-uri20160712-30633-thc30n?AWSAccessKeyId=AKIAJH12345&Expires=1481274629&Signature=Qi1mXnl0ylJ5tCuds789Ocq44L4%3D",
"driver_signed_at": "2016-07-22T14:00:00Z",
"driver_signature_url": "https://keep-truckin-development.s3.amazonaws.com/uploads/inspection_report/driver_signature_upload/9/open-uri20160729-30645-1jeoj77?AWSAccessKeyId=AKIAJH12345&Expires=1481274629&Signature=Qi1mXnl0ylJ5tCuds789Ocq44L4%3D",
"reviewer_signed_at": "2016-07-22T14:00:00Z",
"reviewer_signature_url": "https://keep-truckin-development.s3.amazonaws.com/uploads/inspection_report/reviewer_signature_upload/9/open-uri20160729-30645-1jeoj77?AWSAccessKeyId=AKIAJH12345&Expires=1481274629&Signature=Qi1mXnl0ylJ5tCuds789Ocq44L4%3D",
"entity_num": "entity_num",
"entity_type": "vehicle",
"is_rejected": false,
"inspection_type": "pre-trip",
"declaration": "I declare that this vehicle has been inspected in accordance with the applicable requirements.",
"inspected_parts": [
{
"id": 5,
"category": "Brakes",
"notes": "notes",
"type": "major",
"picture_url": "https://keep-truckin-preview.s3.amazonaws.com/uploads/defect/picture_upload/23137/15c31555-6642-4215-a3cd-81def1d329012396939324379336808.jpg?X",
"defects": [
{
"title": "Air pressure gauge failure",
"severity": "major"
},
{
"title": "Slow air pressure build up rate",
"severity": "major"
},
{
"title": "Air loss rate exceeds prescribed limit",
"severity": "minor"
}
]
}
],
"not_inspected_parts": [
{
"category": "9 - Emergency Equipment & Safety Devices"
},
{
"category": "15 - Heater/Defroster"
}
],
"vehicle": {
"id": 4,
"number": "Demo Vehicle",
"year": "2016",
"make": "Demo",
"model": "Vehicle",
"vin": "WP0AB2966NS458669",
"metric_units": false
},
"asset": {
"id": 101,
"make": "Toyota",
"metric_units": true,
"model": "Camry",
"name": "V123",
"year": 2022
},
"mechanic": {
"id": 12,
"first_name": "Joe",
"last_name": "Williams",
"username": null,
"email": "[email protected]",
"driver_company_id": "123",
"mcleod_id": null,
"status": "active",
"role": "driver"
},
"driver": {
"id": 11,
"first_name": "Demo",
"last_name": "Driver",
"username": "demo_driver",
"email": null,
"driver_company_id": "123",
"mcleod_id": null,
"status": "active",
"role": "driver"
},
"reviewer": {
"id": 13,
"first_name": "John",
"last_name": "Williams",
"username": null,
"email": "[email protected]",
"driver_company_id": "123",
"mcleod_id": null,
"status": "active",
"role": "driver"
},
"external_ids": [
{
"external_id": "201",
"integration_name": "generic_tms"
},
{
"external_id": "Truck123",
"integration_name": "generic_maintenance_system"
}
],
"entries": [
{
"name": "Tractor Plate #",
"value": "2743186",
"position": 1
},
{
"name": "Trailer Plate #",
"value": "T473278",
"position": 2
}
]
}
}
]
}
}
],
"pagination": {
"per_page": 25,
"page_no": 1,
"total": 1
}
}
{
"logs": [
{
"log": {
"id": 47,
"date": "2016-11-22",
"total_miles": 300,
"metric_units": false,
"driver_signed_at": "2016-07-16T00:05:21Z",
"driver_signature_url": "https://keep-truckin-development.s3.amazonaws.com/uploads/log/driver_signature_upload/47/open-uri20160729-30633-1jeoj77?AWSAccessKeyId=AKIAJHHsdfsTJMZBMLQ&Expires=1485085850&Signature=YXqKF9nyfJI%2qEEq3obOLlFzsuKs0%3D",
"time_zone": "Pacific Time (US & Canada)",
"cycle": "70_8",
"driver_first_name": "Demo",
"driver_last_name": "Driver",
"carrier_name": "Demo Carrier",
"carrier_street": "415 Truckin St.",
"carrier_city": "San Francisco",
"carrier_state": "CA",
"carrier_zip": "94105",
"terminal_street": null,
"terminal_city": null,
"terminal_state": null,
"terminal_zip": null,
"notes": null,
"driver_company_id": null,
"origin": null,
"destination": null,
"exception_24_hour_restart": false,
"exception_8_hour_break": false,
"exception_wait_time": false,
"exception_short_haul": false,
"short_haul": false,
"eld_mode": "logs",
"co_driver_full_names": [
],
"odometers": {
},
"trailer_numbers": "17",
"vehicle_numbers": "12345, 12",
"off_duty_duration": 43200,
"on_duty_duration": 7200,
"sleeper_duration": 0,
"driving_duration": 21600,
"waiting_duration": 0,
"driver": {
"id": 11,
"first_name": "Demo",
"last_name": "Driver",
"username": "demo_driver",
"email": null,
"driver_company_id": null,
"status": "active",
"role": "driver"
},
"vehicles": [
{
"vehicle": {
"id": 11,
"number": "12345",
"year": null,
"make": null,
"model": null,
"vin": null,
"metric_units": true
}
}
],
"co_drivers": [
{
"co_driver": {
"id": 33,
"first_name": "John",
"last_name": "Doe",
"username": "johndoe",
"email": "[email protected]",
"driver_company_id": null,
"status": "active",
"role": "driver"
}
}
],
"remarks": [
{
"remark": {
"id": 1,
"time": "2016-10-16T23:59:59Z",
"notes": null,
"location": null
}
}
],
"cycle_restarts": [
{
"cycle_restart": {
"id": 1,
"start_time": "2016-10-16T08:00:00Z",
"end_time": "2016-10-17T05:00:00Z",
"type": "34_hour",
"name": "34 Hour"
}
}
],
"shipping_docs": "123ABC",
"form_and_manner_errors": [
],
"hos_violations": [
{
"hos_violation": {
"id": 12,
"type": "canada_driving_13",
"name": "13 Hour Driving Limit",
"start_time": "2016-10-16T08:00:00Z",
"end_time": "2016-10-17T07:00:00Z"
}
}
],
"events": [
{
"event": {
"id": 221,
"type": "driving",
"notes": null,
"location": "Mobile, AL",
"start_time": "2016-10-16T07:00:00Z",
"end_time": "2016-10-16T09:00:00Z",
"is_manual": false
}
},
{
"event": {
"id": 474,
"type": "sleeper",
"notes": null,
"location": null,
"start_time": "2016-10-16T09:00:00Z",
"end_time": "2016-10-16T11:00:00Z",
"is_manual": false
}
},
{
"event": {
"id": 475,
"type": "driving",
"notes": null,
"location": null,
"start_time": "2016-10-16T11:00:00Z",
"end_time": "2016-10-17T07:00:00Z",
"is_manual": false
}
}
],
"inspection_reports": [
{
"inspection_report": {
"id": 9,
"log_id": 47,
"date": "2016-07-22",
"time": "2016-07-22T14:00:00Z",
"odometer": 253,
"carrier_name": "Demo Carrier",
"location": "Omaha, NE",
"status": "resolved",
"mechanic_signed_at": null,
"mechanic_signature_url": null,
"driver_signed_at": "2016-07-22T14:00:00Z",
"driver_signature_url": "https://keep-truckin-development.s3.amazonaws.com/uploads/inspection_report/driver_signature_upload/9/open-uri20160729-30645-1jeoj77?AWSAccessKeyId=AKIAJH12345&Expires=1481274629&Signature=Qi1mXnl0ylJ5tCuds789Ocq44L4%3D",
"reviewer_signed_at": "2016-07-22T14:00:00Z",
"reviewer_signature_url": "https://keep-truckin-development.s3.amazonaws.com/uploads/inspection_report/reviewer_signature_upload/9/open-uri20160729-30645-1jeoj77?AWSAccessKeyId=AKIAJH12345&Expires=1481274629&Signature=Qi1mXnl0ylJ5tCuds789Ocq44L4%3D",
"entity_num": "entity_num",
"entity_type": "vehicle",
"is_rejected": false,
"inspection_type": "pre-trip",
"declaration": "I declare that this vehicle has been inspected in accordance with the applicable requirements.",
"inspected_parts": [
{
"id": 5,
"category": "Brakes",
"notes": "notes",
"type": "major",
"picture_url": "https://keep-truckin-preview.s3.amazonaws.com/uploads/defect/picture_upload/23137/15c31555-6642-4215-a3cd-81def1d329012396939324379336808.jpg?X",
"status": "[open]/[repaired]/[no_repair_needed]/[good]",
"mechanic_details": {
"resolver": {
"id": 1005,
"first_name": "Joshua",
"last_name": "Lee",
"username": "Joshua Lee",
"email": "[email protected]",
"driver_company_id": "123",
"status": "active",
"role": "driver"
},
"external_resolver_id": "111",
"mechanic_name": "Joshua Lee",
"mechanic_signed_at": "2016-07-22T14:00:00Z",
"mechanic_note": "this is resolved person note, could be anything",
"mechanic_signature": "https://keep-truckin-development.s3.amazonaws.com/uploads/inspection_report/mechanic_signature_upload/9/open-uri20160712-30633-thc30n?AWSAccessKeyId=AKIAJH12345&Expires=1481274629&Signature=Qi1mXnl0ylJ5tCuds789Ocq44L4%3D"
}
}
],
"not_inspected_parts": [
{
"category": "9 - Emergency Equipment & Safety Devices"
},
{
"category": "15 - Heater/Defroster"
}
],
"vehicle": {
"id": 4,
"number": "Demo Vehicle",
"year": "2016",
"make": "Demo",
"model": "Vehicle",
"vin": "WP0AB2966NS458669",
"metric_units": false
},
"asset": {
"id": 101,
"make": "Toyota",
"metric_units": true,
"model": "Camry",
"name": "V123",
"year": 2022
},
"mechanic": {
"id": 12,
"first_name": "Joe",
"last_name": "Williams",
"username": null,
"email": "[email protected]",
"driver_company_id": "123",
"mcleod_id": null,
"status": "active",
"role": "driver"
},
"driver": {
"id": 11,
"first_name": "Demo",
"last_name": "Driver",
"username": "demo_driver",
"email": null,
"driver_company_id": "123",
"mcleod_id": null,
"status": "active",
"role": "driver"
},
"reviewer": {
"id": 13,
"first_name": "John",
"last_name": "Williams",
"username": null,
"email": "[email protected]",
"driver_company_id": "123",
"mcleod_id": null,
"status": "active",
"role": "driver"
},
"external_ids": [
{
"external_id": "201",
"integration_name": "generic_tms"
},
{
"external_id": "Truck123",
"integration_name": "generic_maintenance_system"
}
],
"entries": [
{
"name": "Tractor Plate #",
"value": "2743186",
"position": 1
},
{
"name": "Trailer Plate #",
"value": "T473278",
"position": 2
}
]
}
}
]
}
}
],
"pagination": {
"per_page": 25,
"page_no": 1,
"total": 1
}
}
{
"logs": [
{
"log": {
"id": 47,
"date": "2016-11-22",
"total_miles": 300,
"metric_units": false,
"driver_signed_at": "2016-07-16T00:05:21Z",
"driver_signature_url": "https://keep-truckin-development.s3.amazonaws.com/uploads/log/driver_signature_upload/47/open-uri20160729-30633-1jeoj77?AWSAccessKeyId=AKIAJHHsdfsTJMZBMLQ&Expires=1485085850&Signature=YXqKF9nyfJI%2qEEq3obOLlFzsuKs0%3D",
"time_zone": "Pacific Time (US & Canada)",
"cycle": "70_8",
"driver_first_name": "Demo",
"driver_last_name": "Driver",
"carrier_name": "Demo Carrier",
"carrier_street": "415 Truckin St.",
"carrier_city": "San Francisco",
"carrier_state": "CA",
"carrier_zip": "94105",
"terminal_street": null,
"terminal_city": null,
"terminal_state": null,
"terminal_zip": null,
"notes": null,
"driver_company_id": null,
"origin": null,
"destination": null,
"exception_24_hour_restart": false,
"exception_8_hour_break": false,
"exception_wait_time": false,
"exception_short_haul": false,
"short_haul": false,
"eld_mode": "logs",
"co_driver_full_names": [
],
"odometers": {
},
"trailer_numbers": "17",
"vehicle_numbers": "12345, 12",
"off_duty_duration": 43200,
"on_duty_duration": 7200,
"sleeper_duration": 0,
"driving_duration": 21600,
"waiting_duration": 0,
"driver": {
"id": 11,
"first_name": "Demo",
"last_name": "Driver",
"username": "demo_driver",
"email": null,
"driver_company_id": null,
"status": "active",
"role": "driver"
},
"vehicles": [
{
"vehicle": {
"id": 11,
"number": "12345",
"year": null,
"make": null,
"model": null,
"vin": null,
"metric_units": true
}
}
],
"co_drivers": [
{
"co_driver": {
"id": 33,
"first_name": "John",
"last_name": "Doe",
"username": "johndoe",
"email": "[email protected]",
"driver_company_id": null,
"status": "active",
"role": "driver"
}
}
],
"remarks": [
{
"remark": {
"id": 1,
"time": "2016-10-16T23:59:59Z",
"notes": null,
"location": null
}
}
],
"cycle_restarts": [
{
"cycle_restart": {
"id": 1,
"start_time": "2016-10-16T08:00:00Z",
"end_time": "2016-10-17T05:00:00Z",
"type": "34_hour",
"name": "34 Hour"
}
}
],
"shipping_docs": "123ABC",
"form_and_manner_errors": [
],
"hos_violations": [
{
"hos_violation": {
"id": 12,
"type": "canada_driving_13",
"name": "13 Hour Driving Limit",
"start_time": "2016-10-16T08:00:00Z",
"end_time": "2016-10-17T07:00:00Z"
}
}
],
"events": [
{
"event": {
"id": 221,
"type": "driving",
"notes": null,
"location": "Mobile, AL",
"start_time": "2016-10-16T07:00:00Z",
"end_time": "2016-10-16T09:00:00Z",
"is_manual": false
}
},
{
"event": {
"id": 474,
"type": "sleeper",
"notes": null,
"location": null,
"start_time": "2016-10-16T09:00:00Z",
"end_time": "2016-10-16T11:00:00Z",
"is_manual": false
}
},
{
"event": {
"id": 475,
"type": "driving",
"notes": null,
"location": null,
"start_time": "2016-10-16T11:00:00Z",
"end_time": "2016-10-17T07:00:00Z",
"is_manual": false
}
}
],
"inspection_reports": [
{
"inspection_report": {
"id": 9,
"log_id": 47,
"date": "2016-07-22",
"time": "2016-07-22T14:00:00Z",
"odometer": 253,
"carrier_name": "Demo Carrier",
"location": "Omaha, NE",
"status": "resolved",
"mechanic_signed_at": null,
"mechanic_signature_url": null,
"driver_signed_at": "2016-07-22T14:00:00Z",
"driver_signature_url": "https://keep-truckin-development.s3.amazonaws.com/uploads/inspection_report/driver_signature_upload/9/open-uri20160729-30645-1jeoj77?AWSAccessKeyId=AKIAJH12345&Expires=1481274629&Signature=Qi1mXnl0ylJ5tCuds789Ocq44L4%3D",
"reviewer_signed_at": "2016-07-22T14:00:00Z",
"reviewer_signature_url": "https://keep-truckin-development.s3.amazonaws.com/uploads/inspection_report/reviewer_signature_upload/9/open-uri20160729-30645-1jeoj77?AWSAccessKeyId=AKIAJH12345&Expires=1481274629&Signature=Qi1mXnl0ylJ5tCuds789Ocq44L4%3D",
"entity_num": "entity_num",
"entity_type": "vehicle",
"is_rejected": false,
"inspection_type": "pre-trip",
"declaration": "I declare that this vehicle has been inspected in accordance with the applicable requirements.",
"inspected_parts": [
{
"id": 5,
"category": "Brakes",
"notes": "notes",
"type": "major",
"picture_url": "https://keep-truckin-preview.s3.amazonaws.com/uploads/defect/picture_upload/23137/15c31555-6642-4215-a3cd-81def1d329012396939324379336808.jpg?X",
"status": "[open]/[repaired]/[no_repair_needed]/[good]",
"mechanic_details": {
"resolver": {
"id": 1005,
"first_name": "Joshua",
"last_name": "Lee",
"username": "Joshua Lee",
"email": "[email protected]",
"driver_company_id": "123",
"status": "active",
"role": "driver"
},
"external_resolver_id": "111",
"mechanic_name": "Joshua Lee",
"mechanic_signed_at": "2016-07-22T14:00:00Z",
"mechanic_note": "this is resolved person note, could be anything",
"mechanic_signature": "https://keep-truckin-development.s3.amazonaws.com/uploads/inspection_report/mechanic_signature_upload/9/open-uri20160712-30633-thc30n?AWSAccessKeyId=AKIAJH12345&Expires=1481274629&Signature=Qi1mXnl0ylJ5tCuds789Ocq44L4%3D"
},
"defects": [
{
"title": "Air pressure gauge failure",
"severity": "major"
},
{
"title": "Slow air pressure build up rate",
"severity": "major"
},
{
"title": "Air loss rate exceeds prescribed limit",
"severity": "minor"
}
]
}
],
"not_inspected_parts": [
{
"category": "9 - Emergency Equipment & Safety Devices"
},
{
"category": "15 - Heater/Defroster"
}
],
"vehicle": {
"id": 4,
"number": "Demo Vehicle",
"year": "2016",
"make": "Demo",
"model": "Vehicle",
"vin": "WP0AB2966NS458669",
"metric_units": false
},
"asset": {
"id": 101,
"make": "Toyota",
"metric_units": true,
"model": "Camry",
"name": "V123",
"year": 2022
},
"mechanic": {
"id": 12,
"first_name": "Joe",
"last_name": "Williams",
"username": null,
"email": "[email protected]",
"driver_company_id": "123",
"mcleod_id": null,
"status": "active",
"role": "driver"
},
"driver": {
"id": 11,
"first_name": "Demo",
"last_name": "Driver",
"username": "demo_driver",
"email": null,
"driver_company_id": "123",
"mcleod_id": null,
"status": "active",
"role": "driver"
},
"reviewer": {
"id": 13,
"first_name": "John",
"last_name": "Williams",
"username": null,
"email": "[email protected]",
"driver_company_id": "123",
"mcleod_id": null,
"status": "active",
"role": "driver"
},
"external_ids": [
{
"external_id": "201",
"integration_name": "generic_tms"
},
{
"external_id": "Truck123",
"integration_name": "generic_maintenance_system"
}
],
"entries": [
{
"name": "Tractor Plate #",
"value": "2743186",
"position": 1
},
{
"name": "Trailer Plate #",
"value": "T473278",
"position": 2
}
]
}
}
]
}
}
],
"pagination": {
"per_page": 25,
"page_no": 1,
"total": 1
}
}
require 'uri'
require 'net/http'
url = URI('https://api.gomotive.com/v1/logs')
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
logs
- Type: Array of Objects
- Description: List of logs with detailed information.
log
-
Type: Object
-
Description: Details of a specific log entry.
id
- Type: Integer
- Description: Unique identifier for the log.
date
- Type: String
- Description: Date of the log.
total_miles
- Type: Integer
- Description: Total miles driven on the log date.
metric_units
- Type: Boolean
- Description: Indicates if metric units are used.
driver_signed_at
- Type: String
- Description: Timestamp when the driver signed the log.
driver_signature_url
- Type: String
- Description: URL to the driver's signature.
time_zone
- Type: String
- Description: Time zone for the log.
cycle
- Type: String
- Description: The cycle used in the log.
driver_first_name
- Type: String
- Description: Driver's first name.
driver_last_name
- Type: String
- Description: Driver's last name.
carrier_name
- Type: String
- Description: Carrier's name.
carrier_street
- Type: String
- Description: Carrier's street address.
carrier_city
- Type: String
- Description: Carrier's city.
carrier_state
- Type: String
- Description: Carrier's state.
carrier_zip
- Type: String
- Description: Carrier's ZIP code.
terminal_street
- Type: String
- Description: Terminal street address (if applicable).
terminal_city
- Type: String
- Description: Terminal city (if applicable).
terminal_state
- Type: String
- Description: Terminal state (if applicable).
terminal_zip
- Type: String
- Description: Terminal ZIP code (if applicable).
notes
- Type: String
- Description: Additional notes (if applicable).
driver_company_id
- Type: String
- Description: Driver's company ID (if applicable).
origin
- Type: String
- Description: Origin of the trip (if applicable).
destination
- Type: String
- Description: Destination of the trip (if applicable).
exception_24_hour_restart
- Type: Boolean
- Description: Indicates if the 24-hour restart exception was used.
exception_8_hour_break
- Type: Boolean
- Description: Indicates if the 8-hour break exception was used.
exception_wait_time
- Type: Boolean
- Description: Indicates if the wait time exception was used.
exception_short_haul
- Type: Boolean
- Description: Indicates if the short-haul exception was used.
short_haul
- Type: Boolean
- Description: Indicates if the driver operated under short-haul regulations.
eld_mode
- Type: String
- Description: Vehicle gateway mode that is present in the log.
co_driver_full_names
- Type: Array of Strings
- Description: Full names of co-drivers (if any).
odometers
- Type: Object
- Description: Details of odometer readings (if any).
trailer_numbers
- Type: String
- Description: Numbers of the trailers used.
vehicle_numbers
- Type: String
- Description: Numbers of the vehicles used.
off_duty_duration
- Type: Integer
- Description: Total time spent off-duty (in seconds).
on_duty_duration
- Type: Integer
- Description: Total time spent on-duty (in seconds).
sleeper_duration
- Type: Integer
- Description: Total time spent in the sleeper berth (in seconds).
driving_duration
- Type: Integer
- Description: Total time spent driving (in seconds).
waiting_duration
- Type: Integer
- Description: Total time spent waiting (in seconds).
driver
- Type: Object
- Description: Details of the driver associated with the log.
id
- Type: Integer
- Description: Unique identifier for the driver.
first_name
- Type: String
- Description: Driver's first name.
last_name
- Type: String
- Description: Driver's last name.
username
- Type: String
- Description: Driver's username.
email
- Type: String
- Description: Driver's email address (if applicable).
driver_company_id
- Type: String
- Description: Driver's company ID (if applicable).
status
- Type: String
- Description: Driver's status (e.g., active).
role
- Type: String
- Description: Driver's role.
vehicles
- Type: Array of Objects
- Description: List of vehicles associated with the log.
vehicle
-
Type: Object
-
Description: Details of a specific vehicle.
id
- Type: Integer
- Description: Unique identifier for the vehicle.
number
- Type: String
- Description: Vehicle number.
year
- Type: String
- Description: Year of the vehicle (if applicable).
make
- Type: String
- Description: Make of the vehicle (if applicable).
model
- Type: String
- Description: Model of the vehicle (if applicable).
vin
- Type: String
- Description: Vehicle Identification Number (VIN) (if applicable).
metric_units
- Type: Boolean
- Description: Indicates if metric units are used for the vehicle.
co_drivers
- Type: Array of Objects
- Description: List of co-drivers associated with the log.
co_driver
-
Type: Object
-
Description: Details of a specific co-driver.
id
- Type: Integer
- Description: Unique identifier for the co-driver.
first_name
- Type: String
- Description: Co-driver's first name.
last_name
- Type: String
- Description: Co-driver's last name.
username
- Type: String
- Description: Co-driver's username.
email
- Type: String
- Description: Co-driver's email address.
driver_company_id
- Type: String
- Description: Co-driver's company ID (if applicable).
status
- Type: String
- Description: Co-driver's status (e.g., active)
remarks
- Type: Array of Objects
- Description: List of remarks associated with the log.
remark
-
Type: Object
-
Description: Details of a specific remark.
id
- Type: Integer
- Description: Unique identifier for the remark.
time
- Type: String
- Description: Timestamp of the remark.
notes
- Type: String
- Description: Notes associated with the remark (if applicable).
location
- Type: String
- Description: Location associated with the remark (if applicable).
cycle_restarts
- Type: Array of Objects
- Description: List of cycle restarts associated with the log.
cycle_restart
-
Type: Object
-
Description: Details of a specific cycle restart.
id
- Type: Integer
- Description: Unique identifier for the cycle restart.
start_time
- Type: String
- Description: Start time of the cycle restart.
end_time
- Type: String
- Description: End time of the cycle restart.
type
- Type: String
- Description: Type of cycle restart (e.g., 34_hour).
name
- Type: String
- Description: Name of the cycle restart.
shipping_docs
- Type: String
- Description: Shipping document numbers associated with the log.
form_and_manner_errors
- Type: Array
- Description: List of form and manner errors (if any).
hos_violations
- Type: Array of Objects
- Description: List of Hours of Service (HOS) violations associated with the log.
hos_violation
-
Type: Object
-
Description: Details of a specific HOS violation.
id
- Type: Integer
- Description: Unique identifier for the HOS violation.
type
- Type: String
- Description: Type of HOS violation.
name
- Type: String
- Description: Name of the HOS violation.
start_time
- Type: String
- Description: Start time of the HOS violation.
end_time
- Type: String
- Description: End time of the HOS violation.
events
- Type: Array of Objects
- Description: List of events associated with the log.
event
-
Type: Object
-
Description: Details of a specific event.
id
- Type: Integer
- Description: Unique identifier for the event.
type
- Type: String
- Description: Type of event (e.g., driving, sleeper).
notes
- Type: String
- Description: Notes associated with the event (if applicable).
location
- Type: String
- Description: Location of the event (if applicable).
start_time
- Type: String
- Description: Start time of the event.
end_time
- Type: String
- Description: End time of the event.
is_manual
- Type: Boolean
- Description: Indicates if the event was manually entered.
inspection_reports
- Type: Array of Objects
- Description: List of inspection reports associated with the log.
inspection_report
-
Type: Object
-
Description: Details of a specific inspection report.
id
- Type: Integer
- Description: Unique identifier for the inspection report.
date
- Type: String
- Description: Date of the inspection.
time
- Type: String
- Description: Time of the inspection.
odometer
- Type: Integer
- Description: Odometer reading at the time of the inspection (if applicable).
carrier_name
- Type: String
- Description: Carrier's name.
vehicle_number
- Type: String
- Description: Vehicle number associated with the inspection.
trailer_nums
- Type: Array of Strings
- Description: Trailer numbers associated with the inspection.
location
- Type: String
- Description: Location of the inspection.
city
- Type: String
- Description: City of the inspection.
state
- Type: String
- Description: State of the inspection.
status
- Type: String
- Description: Status of the inspection (e.g., corrected).
mechanic_signed_at
- Type: String
- Description: Timestamp when the mechanic signed the inspection report.
mechanic_signature_url
- Type: String
- Description: URL to the mechanic's signature.
driver_signed_at
- Type: String
- Description: Timestamp when the driver signed the inspection report.
driver_signature_url
- Type: String
- Description: URL to the driver's signature.
reviewer_signed_at
- Type: String
- Description: Timestamp when the reviewer signed the inspection report.
reviewer_signature_url
- Type: String
- Description: URL to the reviewer's signature.
defects
-
Type: Array of Objects
-
Description: List of defects identified during the inspection.
defect
-
Type: Object
-
Description: Details of a specific defect.
id
- Type: Integer
- Description: Unique identifier for the defect.
area
- Type: String
- Description: Area of the vehicle where the defect was found.
category
- Type: String
- Description: Category of the defect.
notes
- Type: String
- Description: Additional notes about the defect (if applicable).
entries
-
Type: Array of Objects
-
Description: List of additional entries in the inspection report.
name
- Type: String
- Description: Name of the entry.
value
- Type: String
- Description: Value of the entry.
position
- Type: Integer
- Description: Position of the entry in the inspection report.