v1
latestOpenAPI 3.1.02026-07-2617501.1 MBList all the vehicles and their locations (v3)
This API is only meant for vehicles with the Motive Vehicle Gateway. For others, you may use the V1 or V2 API.
get/v3/vehicle_locations
Query parameters
vehicle_ids[]integer[]
Enter the id of the vehicle for which you want to check the location. NOTE: The endpoint has a limit of 100 vehicles for fetching their locations.
vehicle_statusstring
Enter the status of the vehicle whose location you want to check. The status can be "active", or "deactivated".
per_pageinteger
Number of records to return per page.
page_nointeger
Denotes the current page number.
include_aux_detailsboolean
Specify if you want to include the auxiliary status in the response.
Headers
X-Time-Zonestring
Time zone used to format timestamps.
X-Metric-Unitsboolean
System of units to use to convert different metrics. true for metric units and false for imperial units.
X-User-Idinteger
ID of the Fleet Admin accessing the API.
Response
200
Example response
{
"vehicles": [
{
"vehicle": {
"id": 998707,
"number": "Angela Mahoney",
"year": "2014",
"make": "Ford",
"model": "Fusion",
"vin": "3FA6P0H97ER281302",
"aux_status": {
"AUX1": {
"present": true,
"end_time": "2023-03-10T14:22:25+00:00",
"start_time": "2023-03-10T14:19:53+00:00",
"aux_equipment_type": "PTO"
},
"AUX2": {
"present": true,
"end_time": "2023-03-28T14:17:29+00:00",
"start_time": "2023-03-10T14:14:48+00:00",
"aux_equipment_type": "PANIC_BUTTON"
}
},
"current_location": {
"lat": 27.4637528,
"lon": -82.5783576,
"located_at": "2024-05-24T16:34:49Z",
"city": "South Bradenton",
"state": "FL",
"rg_km": 0.3439441534173073,
"rg_brg": 79.0852179704791,
"rg_match": true,
"vehicle_state": "off",
"current_location": "18th Street West, Bradenton, FL 34205"
}
}
}
],
"pagination": {
"per_page": 25,
"page_no": 1,
"total": 5
}
}