OAuth Scopes
This page lists all the supported OAuth scopes of Motive APIs.
All the GET endpoints require READ access, where as any other method will require WRITE access.
NOTE
It is recommended to enable /companies endpoints by default. This endpoint will provide all the necessary information to the developer regarding the companies. Otherwise, it will be harder for you to distinguish the access token for a given company.
| Category | Permission Scopes | Access Type | Endpoints Allowed |
|---|---|---|---|
| Drivers and Fleet Managers | users.read users.manage | - Read - Write | GET /:version/users GET /:version/users/:id PUT /:version/users/:id POST /:version/users GET /:version/users/lookup GET /:version/users/lookup_by_external_id GET /:version/users/user_roles |
| Vehicles | vehicles.read vehicles.manage | - Read - Write | GET /:version/vehicles GET /:version/vehicles/:id POST /:version/vehicles PUT /:version/vehicles/:id GET /:version/vehicles/lookup GET /:version/vehicles/lookup_by_external_id |
| Messages | messages.read messages.manage | - Read - Write | GET /:version/messages POST /:version/messages PUT /:version/messages |
| Fuel Purchases | fuel_purchases.read fuel_purchases.manage | - Read - Write | GET /:version/fuel_purchases GET /:version/fuel_purchases/:id POST /:version/fuel_purchases POST /:version/fuel_purchase_imports PUT /:version/fuel_purchases/:id DELETE /:version/fuel_purchases/:id |
| Groups | groups.read groups.manage | - Read - Write | GET /:version/groups POST /:version/groups GET /:version/groups/:id DELETE /:version/groups/:id PUT /:version/groups/:id GET /:version/groups/:id/users GET /:version/groups/:id/drivers GET /:version/groups/:id/fleet_managers GET /:version/groups/:id/vehicles GET /:version/groups/:id/assets POST /:version/groups/:id/users POST /:version/groups/:id/vehicles DELETE /:version/groups/:id/users DELETE /:version/groups/:id/vehicles POST /:version/groups/:id/assets DELETE /:version/groups/:id/assets GET /:version/groups/:id/geofence POST /:version/groups/:id/geofences DELETE /:version/groups/:id/geofences |
| ELDs | eld_devices.read | - Read | GET /:version/eld_devices |
| Inspection Reports | inspection_reports.read inspections_reports.manage | - Read - Write | GET /:version/inspection_reports PUT. /: version/inspection_reports/{id} GET /:version/inspection_reports/lookup_by_external_id |
| Fault Codes | fault_codes.read | - Read | GET /:version/fault_codes |
| Scorecards | scorecard_summary.read | - Read | GET /:version/scorecard_summary |
| Drivers with Available Time | hos_logs.available_time | - Read | GET /:version/available_time |
| Drivers with Hours of Service | hos_logs.hours_of_service | - Read | GET /:version/hours_of_service |
| HOS Violations | hos_logs.hos_violation | - Read | GET /:version/hos_violations |
| HOS Logs | hos_logs.logs hos_logs.read hos_logs.manage | - Read - Write | GET /:version/logs GET /:version/log_suggestions POST /:version/log_suggestions PUT /:version/log_suggestions/{id} |
| Vehicles with Current Location and Current Driver | locations.vehicle_locations_list | - Read | GET /:version/vehicle_locations |
| Vehicle Location History | locations.vehicle_locations.single | - Read | GET /:version/vehicle_locations/{id} |
| Drivers with Current Location and Current Vehicle | locations.driver_locations | - Read | GET /:version/driver_locations |
| IFTA Trip Reports | ifta_reports.trips | - Read | GET /:version/ifta/trips |
| Vehicles' Mileage Summary | ifta_reports.summary | - Read | GET /:version/ifta/summary |
| Utilization Summary by Driver | utilization.driver_utilization | - Read | GET /:version/driver_utilization |
| Utilization Summary by Vehicle | utilization.vehicle_utilization | - Read | GET /:version/vehicle_utilization |
| Utilization Records | utilization.idle_events | - Read | GET /:version/idle_events |
| Company Details | companies.read | - Read | GET /:version/companies |
| Dispatch Forms | forms.read | - Read | GET /:version/forms |
| Dispatch Form Entries | form_entries.read | - Read | GET /:version/form_entries |
| Dispatch Locations | dispatch_locations.read dispatch_locations.manage | - Read - Write | GET /:version/dispatch_locations POST /:version/dispatch_locations PUT /:version/dispatch_locations DELETE /:version/dispatch_locations |
| Dispatches | dispatches.read dispatches.manage | - Read - Write | GET /:version/dispatches POST /:version/dispatches PUT /:version/dispatches |
| Geofences | geofences.read geofences.manage | - Read - Write | GET /:version/geofences POST /:version/geofences GET /:version/geofences/:id PUT /:version/geofences/:id DELETE /:version/geofences/:id GET /:version/geofences/circular |
| Geofence Events | geofence_events.read geofence_asset_events.read | - Read | GET /:version/geofences/events GET /:version/geofences/asset_events |
| Documents | documents.read documents.manage | - Read - Write | GET /:version/documents POST /:version/documents GET /:version/documents/:id PUT /:version/documents/:id DELETE /:version/documents/:id GET /:version/documents/forms |
| Driver Performance Events | driver_performance_events.read | - Read | GET. /:version/driver_performance_events GET /:version/speeding_events |
| Assets | assets.read assets.manage | - Read - Write | GET /:version/assets GET /:version/lookup_by_external_id POST /:version/assets PUT /:version/assets/{id} GET /:version/reefer_activity_reports |
| Asset with Asset Gateway Location History | locations.asset_locations | - Read | GET /:version/asset_locations GET /:version/asset_locations/:id |
| Camera Connections | camera_connections.read | - Read | GET /:version/camera_connectionsMotive |
| Motive Cards | motive_card_transactions.read motive_card_cards.read motive_card_cards.manage motive_card_spend_profiles.read motive_card_spend_profiles.manage | - Read - Write | GET /:version/transactions GET /:version/cards GET /:version/cards/{card_id} POST /:version/cards/{card_id}/actions GET /:version/spend_profiles GET /:version/spend_profiles/{spend_profile_id} PATCH /:version/cards/{card_id} |
Updated 4 days ago