Jump to Content
Motive Public API
API Reference
Log InMotive Public API
Log In
API Reference

Overview

  • Introduction
    • Endpoints
    • Authentication
    • Authorization (OAuth 2.0)
    • OAuth Scopes
    • Time Zone
    • System of Units
    • API User
    • HTTP Version
    • Request Methods
    • Request Content Type
    • Response Codes
    • Response Formats
    • Pagination
    • Changelog

Sample Workflows

  • Freight Visibility Workflow
    • Step 1. Get a list of the carriers who have consented to expose their Freight Visibility to you.get
    • Step 2. Get locations of all vehicles of a company and their proximity to your location of interest.get
    • Step 3. Start tracking the vehicle of your choice by subscribing to its location.post
    • Step 4. Modify the subscription to change tracking time.put
    • Step 5. Get location updates for all your subscribed vehicle locations.get
    • Step 6. Get past locations for a specific vehicle.get
    • Step 7. Get locations of all assets of a company and their proximity to your location of interest.get
    • Step 8. Get aggregated location updates for all your subscribed asset locations.get
  • TMS Integration Workflow
    • Step 1. Begin setup: sync your users.put
    • Step 2. Sync your vehicles.put
    • Step 3. Sync your assets.put
    • Step 4. Complete setup: sync your geofences.post
    • Step 5. Track vehicles and assets.get
    • Step 6. Get drivers’ available time.get
    • Step 7. Communicate with your drivers.post
    • Step 8. Get the forms you can use for a dispatch.get
    • Step 9. Get the list of stops for your dispatch.get
    • Step 10. Create a dispatch!post
    • Step 11. Update the planned dispatch.put
    • Step 12. Get updates.get
    • Step 13. Get vehicle utilization reports.get
    • Step 14. Get and update inspection reports.get

Users

  • Overview
  • /usersget
  • /users/:idget
  • /userspost
  • /usersput
  • /users/lookupget
  • /users/lookup_by_external_idget

Vehicles

  • Overview
  • /vehiclesget
  • /vehicles/:idget
  • /vehiclespost
  • /vehicles/:idput
  • /vehicles/lookupget
  • /vehicles/lookup_by_external_idget

ELD Devices

  • Overview
  • /eld_devicesget

Groups

  • Overview
  • /groupsget
  • /groups/:idget
  • /groupspost
  • /groups/:idput
  • /groups/:iddelete
  • /groups/:id/usersget
  • /groups/:id/userspost
  • /groups/:id/usersdelete
  • /groups/:id/vehiclesget
  • /groups/:id/vehiclespost
  • /groups/:id/vehiclesdelete

HOS Logs

  • Overview
  • /available_timeget
  • /hours_of_serviceget
  • /hos_violationsget
  • /logsget

Locations

  • Overview
  • /vehicle_locationsget
  • /vehicle_locations (v2)get
  • /vehicle_locations/:idget
  • /vehicle_locations/:id (v2)get
  • /vehicle_locations/:id (v3)get
  • /driver_locationsget
  • /asset_locationsget
  • /asset_locations/:idget

Messages

  • Overview
  • /messagesget
  • /messagespost
  • /messagesput
  • /messages (v2)get
  • /messages (v2)post

Inspection Reports

  • Overview
  • /inspection_reportsget
  • /inspection_reports/:idput
  • /inspection_reports/lookup_by_external_idget

IFTA Reports

  • Overview
  • /ifta/tripsget
  • /ifta/summaryget

Fault Codes

  • Overview
  • /fault_codesget

Driver Performance Events

  • Overview
  • /driver_performance_eventsget

Driving Periods

  • Overview
  • /driving_periodsget

Scorecard Summary

  • Overview
  • /scorecard_summaryget

Company Webhooks

  • Overview
  • /company_webhooksget
  • /company_webhooks/:idget
  • /company_webhookspost
  • /company_webhooks/:idput
  • /company_webhook_requestsget
  • /company_webhook_requests/retrypost

Fuel Purchases

  • Overview
  • /fuel_purchasesget
  • /fuel_purchases/:idget
  • /fuel_purchasespost
  • /fuel_purchase_importspost
  • /fuel_purchases/:idput
  • /fuel_purchases/:iddelete

Utilization

  • Overview
  • /driver_utilizationget
  • /driver_utilizationget
  • /vehicle_utilizationget
  • /idle_eventsget

Forms

  • Overview
  • /formsget

Form Entries

  • Overview
  • /form_entriesget

Dispatch Locations

  • Overview
  • /dispatch_locationsget
  • /dispatch_locationspost
  • /dispatch_locationsput
  • /dispatch_locationsdelete

Dispatches

  • Overview
  • /dispatchesget
  • /dispatchespost
  • /dispatchesput

Dispatches (v2)

  • Overview
  • /dispatchesget
  • /dispatchespost
  • /dispatchesput

Documents

  • Overview
  • /documentsget
  • /documents/:idget
  • /documentspost
  • /documents/:idput
  • /documents/:iddelete
  • /documents/forms (v2)get
    • /documents/forms/:id (v2)get
  • /documents (v2)get
  • /documents/:id (v2)get
  • /documents (v2)post
  • /documents/:id (v2)put

Geofences

  • Overview
  • /geofencesget
  • /geofences/:idget
  • /geofencespost
  • /geofences/:idput
  • /geofences/:iddelete
  • /geofences/eventsget
  • /geofences/asset_eventsget

Freight Visibility

  • Overview
  • freight_visibility/vehicle_locationsget
  • freight_visibility/subscribepost
  • freight_visibility/subscribeput
  • freight_visibility/subscribedelete
  • freight_visibility/companiesget
  • freight_visibility/company_associatedget
  • freight_visibility/vehicle_associationget
  • freight_visibility/vehicle_association (v2)get
  • freight_visibility/vehicle_subscriptionsget
  • freight_visibility/vehicle_locations/detailsget
  • freight_visibility/asset_associationget
  • freight_visibility/asset_locationsget

Assets

  • Overview
  • /assetsget
  • /assets/lookup_by_external_idget
  • /assetspost
  • /assets/:idput

Freight MarketPlace API

  • FreightMarketplaceAPI
    • List carriersget
    • Create a carrierpost
    • Update a carrierput
    • Update a carrierpatch
    • View a carrierget
    • Delete a carrierdelete
    • List loadsget
    • Create a loadpost
    • View multiple loadspost
    • Create loads in bulkpost
    • Update loads in bulkput
    • Update loads in bulkpatch
    • Update a loadput
    • Update a loadpatch
    • View a loadget
    • Delete a loaddelete
    • Get preferencesget
    • Offers Webhook Flow
    • <