Overview of /users
For an example of how to use our /users endpoints in a typical business scenario, refer to TMS Integration Workflow.
A users object represents a driver or a fleet manager. The fleet's data is either associated with a user, vehicle, or both. User can have one the following three roles: driver, fleet_admin, or fleet_user.
Drivers can login to the Motive's mobile app, record Hours of Service logs, create inspection reports, upload documents, send messages, etc. In order to calculate availability times and determine if your driver has a violation on his logs, we require you to select a HOS cycle for your driver. Each HOS cycle listed below has some additional exceptions that you can select from:
Cycle API Value | Description | Allowed Exceptions | Violations |
|---|---|---|---|
70_8 | USA Property 70 hour / 8 day | exception_24_hour_restart | duty_16 |
60_7 | USA Property 60 hour / 7 day | exception_24_hour_restart | duty_16 |
70_8_o | USA Oil and Gas 70 hour / 8 day | exception_24_hour_restart | duty_16 |
60_7_o | USA Oil and Gas 60 hour / 7 day | exception_24_hour_restart | duty_16 |
70_8_p | USA Passenger 70 hour / 8 day | duty_15 | |
60_7_p | USA Passenger 60 hour / 7 day | duty_15 | |
80_8 | California Property 80 hour / 8 day | exception_24_hour_restart | ca_driving_12 |
80_8_o | California Oil and Gas 80 hour / 8 day | exception_24_hour_restart | ca_driving_12 |
80_8_p | California Passenger 80 hour / 8 day | exception_ca_farm_school_bus | ca_driving_10 |
tx_70_7 | Texas 70 hour / 7 day | exception_24_hour_restart | tx_driving_12 |
ak_70_7 | Alaska Property 70 hour / 7 day | exception_24_hour_restart | ak_duty_20, |
ak_80_8 | Alaska Property 80 hour / 8 day | exception_24_hour_restart | ak_duty_20, |
ak_70_7_o | Alaska Oil and Gas 70 hour / 7 day | exception_24_hour_restart | ak_duty_20, |
ak_80_8_o | Alaska Oil and Gas 80 hour / 8 day | exception_24_hour_restart | ak_duty_20, |
ak_70_7_p | Alaska Passenger 70 hour / 7 day | ak_duty_20 | |
ak_80_8_p | Alaska Passenger 80 hour / 8 day | ak_duty_20 | |
70_7 | Canada South 70 hour / 7 day (Cycle 1) | canada_driving_13 | |
120_14 | Canada South 120 hour / 14 day (Cycle 2) | canada_driving_13 | |
canada_oil | Canada South Oil and Gas | exception_wait_time | canada_oil_driving_13 |
80_7 | Canada North 80 hour / 7 day (Cycle 1) | canada_driving_15 | |
120_14_north | Canada North 120 hour / 14 day (Cycle 2) | canada_driving_15 | |
Other | Other |
Following is the list of exceptions with description:
Exception API name | Description |
|---|---|
exception_24_hour_restart | 24 hour restart exception allows any 24+ hour "off_duty" or "sleeper" period to start a new cycle. |
exception_8_hour_break | 8 hour break exception exempts the driver from taking 30+ minutes breaks. |
exception_wait_time | Wait time exception adds a 5th status to the log chart and any time spent waiting does not count towards the 14 hour shift limit. |
exception_short_haul | Short haul exception allows a 16 hour shift once per week or after a 34 hour restart. |
exception_ca_farm_school_bus | Farm/School bus exception allows for a 16 hour shift limit. |
Following is this list of violations with description:
Violation API name | Description |
|---|---|
break_30 | 30 Minute Break Required |
driving_11 | 11 Hour Driving Limit |
duty_14 | 14 Hour Shift Limit |
duty_16 | 16 Hour Shift Limit |
cycle_60 | 60 Hour Cycle Limit |
cycle_70 | 70 Hour Cycle Limit |
driving_10 | 10 Hour Driving Limit |
duty_15 | 15 Hour On Duty Limit |
cycle_60_p | 60 Hour Cycle Limit |
cycle_70_p | 70 Hour Cycle Limit |
canada_driving_13 | 13 Hour Driving Limit |
canada_driving_15 | 15 Hour Driving Limit |
canada_duty_14 | 14 Hour On Duty Limit |
canada_duty_16 | 16 Hour Shift Limit |
canada_duty_18 | 18 Hour On Duty Limit |
canada_duty_20 | 20 Hour Shift Limit |
canada_daily_break_8 | Daily 8 Hours Off Duty Required |
canada_daily_break_10 | Daily 10 Hours Off Duty Required |
canada_daily_driving_13 | Daily 13 Hour Driving Limit |
canada_daily_duty_14 | Daily 14 Hour On Duty Limit |
canada_cycle_70 | 70 Hour Cycle Limit |
canada_cycle_80 | 80 Hour Cycle Limit |
canada_cycle_120 | 120 Hour Cycle Limit |
canada_break_24 | 24 Hour Break Required |
canada_break_24_70 | 24 Hour Break Required |
canada_break_24_80 | 24 Hour Break Required |
canada_oil_driving_13 | 13 Hour Driving Limit |
canada_oil_duty_14 | 14 Hour On Duty Limit |
canada_oil_duty_16 | 16 Hour Shift Limit |
canada_oil_break_3_24 | Three 24 Hour Breaks Required |
canada_oil_daily_driving_13 | Daily 13 Hour Driving Limit |
canada_oil_daily_duty_14 | Daily 14 Hour On Duty Limit |
canada_oil_daily_break_10 | Daily 10 Hours Off Duty Required |
ca_driving_12 | 12 Hour Driving Limit |
ca_duty_16 | 16 Hour Shift Limit |
ca_cycle_80 | 80 Hour Cycle Limit |
ca_driving_10 | 10 Hour Driving Limit |
ca_duty_15 | 15 Hour On Duty Limit |
ca_duty_16_p | 16 Hour On Duty Limit |
ca_cycle_80_p | 80 Hour Cycle Limit |
tx_driving_12 | 12 Hour Driving Limit |
tx_duty_15 | 15 Hour On Duty Limit |
tx_cycle_70 | 70 Hour Cycle Limit |
ak_cycle_70 | 70 Hour Cycle Limit |
ak_cycle_80 | 80 Hour Cycle Limit |
ak_duty_20 | 20 Hour Shift Limit |
ak_driving_15 | 15 Hour Driving Limit |
ak_cycle_70_p | 70 Hour Cycle Limit |
ak_cycle_80_p | 80 Hour Cycle Limit |
Behind the scenes, we also track driver's performance, time driver spends driving vs idling, etc. This data is automatically recorded from the hardware device and is associated with the driver based on his driving records.
Fleet admins or fleet users have access to Motive's web dashboard. You can look at drivers' or vehicles' data and manage the fleet. Please note that fleet managers cannot use Motive's driver mobile app.
Following set of endpoints can be used to manage users including getting existing users' information, provisioning new users, and modifying users' settings.
Deleting Users
Once a user is created, it cannot be deleted. The status of the user can be set to deactivated, but it is not same as deleting the user. You will continue to see the provisioned user in the web dashboard.