GOgomotive

List 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

Request

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
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.