Overview

Fetch a list of all the vehicles and their locations

  • Endpoint: v1/vehicle_locations
  • Description: Retrieves the location information for all vehicles in the fleet, including real-time or last-known locations.
  • Use Case: This endpoint is essential for fleet managers to monitor vehicle positions across a fleet, enhancing route management, driver coordination, and responding to incidents.

Fetch a list of all the vehicles and their locations (v2)

  • Endpoint: v2/vehicle_locations
  • Description: Provides an updated version of vehicle location data with enhanced details or structure changes compared to v1.
  • Use Case: Fleet operators use this to access refined vehicle location data, improving tracking and operational insights.

Fetch a list of all the vehicles and their locations (v3)

  • Endpoint: v3/vehicle_locations
  • Description: Retrieves the location information for all vehicles in the fleet, including real-time or last-known locations.
    NOTE: This endpoint is only to be used with vehicles that have the Motive Vehicle Gateway installed. For other vehicles, use the v1 and v2 endpoints.
  • Use Case: Fleet operators use this to access refined vehicle location data, improving tracking and operational insights.

Fetch a vehicle's location using its ID

  • Endpoint: v1/vehicle_locations?{id}?date={date}
  • Description: Retrieves the location for a specific vehicle on a particular date, allowing historical location lookup.
  • Use Case: Useful for investigating past trips, audits, or verifying route adherence for a given vehicle on a specified date.

Fetch a vehicle's location using its ID (v2)

  • Endpoint: v2/vehicle_locations/{id}
  • Description: Provides an updated version of vehicle-specific location data.
  • Use Case: Fleet managers leverage this to access more detailed location data for individual vehicles, aiding in operational analysis and trip tracking.

Fetch a vehicle's location using its ID (v3)

  • Endpoint: v3/vehicle_locations/{id}?
  • Description: Use this API to fetch the location of a particular vehicle using its ID.
  • Use Case: Fleet managers leverage this to access more detailed location data for individual vehicles, aiding in operational analysis and trip tracking.

Fetch a list of all the drivers with location and vehicle info

  • Endpoint: v1/driver_locations
  • Description: Provides a detailed list of all the drivers, their location, and the vehicle info.
  • Use Case: Fleet managers leverage this to access more detailed location data for individual vehicles, aiding in operational analysis and trip tracking.

Fetch a list of all the assets and their locations

  • Endpoint: v1/asset_locations
  • Description: Returns location details for all company assets, which could include vehicles, trailers, and other valuable equipment.
  • Use Case: Useful for logistics managers to track and manage the distribution of assets across locations, enhancing asset utilization and security.

Fetch a list of all the assets and their locations using their IDs

  • Endpoint: v1/asset_locations/[id{}
  • Description: Provides location data for specific assets identified by their IDs, allowing precise asset tracking.
  • Use Case: Ideal for locating high-value or sensitive assets quickly, especially when managing large or distributed inventories.