Overview

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 ValueDescriptionAllowed ExceptionsViolations
70_8USA Property 70 hour / 8 dayexception_24_hour_restart
exception_8_hour_break
exception_short_haul
duty_16
duty_14
driving_11
break_30
cycle_70
60_7USA Property 60 hour / 7 dayexception_24_hour_restart
exception_8_hour_break
exception_short_haul
duty_16
duty_14
driving_11
break_30
cycle_60
70_8_oUSA Oil and Gas 70 hour / 8 dayexception_24_hour_restart
exception_8_hour_break
exception_wait_time
exception_short_haul
duty_16
duty_14
driving_11
break_30
cycle_70
60_7_oUSA Oil and Gas 60 hour / 7 dayexception_24_hour_restart
exception_8_hour_break
exception_wait_time
exception_short_haul
duty_16
duty_14
driving_11
break_30
cycle_60
70_8_pUSA Passenger 70 hour / 8 dayduty_15
driving_10
cycle_70_p
60_7_pUSA Passenger 60 hour / 7 dayduty_15
driving_10
cycle_60_p
80_8California Property 80 hour / 8 dayexception_24_hour_restartca_driving_12
ca_duty_16
ca_cycle_80
80_8_oCalifornia Oil and Gas 80 hour / 8 dayexception_24_hour_restart
exception_wait_time
ca_driving_12
ca_duty_16
ca_cycle_80
80_8_pCalifornia Passenger 80 hour / 8 dayexception_ca_farm_school_busca_driving_10
ca_duty_15
ca_cycle_80_p
ca_duty_16
tx_70_7Texas 70 hour / 7 dayexception_24_hour_restarttx_driving_12
tx_duty_15
tx_cycle_70
ak_70_7Alaska Property 70 hour / 7 dayexception_24_hour_restartak_duty_20,
ak_driving_15,
ak_cycle_70
ak_80_8Alaska Property 80 hour / 8 dayexception_24_hour_restartak_duty_20,
ak_driving_15,
ak_cycle_80
ak_70_7_oAlaska Oil and Gas 70 hour / 7 dayexception_24_hour_restart
exception_wait_time
ak_duty_20,
ak_driving_15,
ak_cycle_70
ak_80_8_oAlaska Oil and Gas 80 hour / 8 dayexception_24_hour_restart
exception_wait_time
ak_duty_20,
ak_driving_15,
ak_cycle_80
ak_70_7_pAlaska Passenger 70 hour / 7 dayak_duty_20
ak_driving_15
ak_cycle_70_p
ak_80_8_pAlaska Passenger 80 hour / 8 dayak_duty_20
ak_driving_15
ak_cycle_80_p
70_7Canada South 70 hour / 7 day (Cycle 1)canada_driving_13
canada_duty_14
canada_duty_16
canada_daily_driving_13
canada_daily_duty_14
canada_daily_break_10
canada_cycle_70
canada_break_24
120_14Canada South 120 hour / 14 day (Cycle 2)canada_driving_13
canada_duty_14
canada_duty_16
canada_daily_driving_13
canada_daily_duty_14
canada_daily_break_10
canada_cycle_120
canada_break_24
canada_break_24_70
canada_oilCanada South Oil and Gasexception_wait_timecanada_oil_driving_13
canada_oil_duty_14
canada_oil_duty_16
canada_oil_daily_driving_13
canada_oil_daily_duty_14
canada_oil_daily_break_10
canada_oil_break_3_24
80_7Canada North 80 hour / 7 day (Cycle 1)canada_driving_15
canada_duty_18
canada_duty_20
canada_daily_break_8
canada_cycle_80
canada_break_24
120_14_northCanada North 120 hour / 14 day (Cycle 2)canada_driving_15
canada_duty_18
canada_duty_20
canada_daily_break_8
canada_cycle_120
canada_break_24_80
OtherOther

Following is the list of exceptions with description:

Exception API nameDescription
exception_24_hour_restart24 hour restart exception allows any 24+ hour "off_duty" or "sleeper" period to start a new cycle.
exception_8_hour_break8 hour break exception exempts the driver from taking 30+ minutes breaks.
exception_wait_timeWait 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_haulShort haul exception allows a 16 hour shift once per week or after a 34 hour restart.
exception_ca_farm_school_busFarm/School bus exception allows for a 16 hour shift limit.

Following is this list of violations with description:

Violation API nameDescription
break_3030 Minute Break Required
driving_1111 Hour Driving Limit
duty_1414 Hour Shift Limit
duty_1616 Hour Shift Limit
cycle_6060 Hour Cycle Limit
cycle_7070 Hour Cycle Limit
driving_1010 Hour Driving Limit
duty_1515 Hour On Duty Limit
cycle_60_p60 Hour Cycle Limit
cycle_70_p70 Hour Cycle Limit
canada_driving_1313 Hour Driving Limit
canada_driving_1515 Hour Driving Limit
canada_duty_1414 Hour On Duty Limit
canada_duty_1616 Hour Shift Limit
canada_duty_1818 Hour On Duty Limit
canada_duty_2020 Hour Shift Limit
canada_daily_break_8Daily 8 Hours Off Duty Required
canada_daily_break_10Daily 10 Hours Off Duty Required
canada_daily_driving_13Daily 13 Hour Driving Limit
canada_daily_duty_14Daily 14 Hour On Duty Limit
canada_cycle_7070 Hour Cycle Limit
canada_cycle_8080 Hour Cycle Limit
canada_cycle_120120 Hour Cycle Limit
canada_break_2424 Hour Break Required
canada_break_24_7024 Hour Break Required
canada_break_24_8024 Hour Break Required
canada_oil_driving_1313 Hour Driving Limit
canada_oil_duty_1414 Hour On Duty Limit
canada_oil_duty_1616 Hour Shift Limit
canada_oil_break_3_24Three 24 Hour Breaks Required
canada_oil_daily_driving_13Daily 13 Hour Driving Limit
canada_oil_daily_duty_14Daily 14 Hour On Duty Limit
canada_oil_daily_break_10Daily 10 Hours Off Duty Required
ca_driving_1212 Hour Driving Limit
ca_duty_1616 Hour Shift Limit
ca_cycle_8080 Hour Cycle Limit
ca_driving_1010 Hour Driving Limit
ca_duty_1515 Hour On Duty Limit
ca_duty_16_p16 Hour On Duty Limit
ca_cycle_80_p80 Hour Cycle Limit
tx_driving_1212 Hour Driving Limit
tx_duty_1515 Hour On Duty Limit
tx_cycle_7070 Hour Cycle Limit
ak_cycle_7070 Hour Cycle Limit
ak_cycle_8080 Hour Cycle Limit
ak_duty_2020 Hour Shift Limit
ak_driving_1515 Hour Driving Limit
ak_cycle_70_p70 Hour Cycle Limit
ak_cycle_80_p80 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.