---
title: "List all the vehicles and their locations (v3)"
method: GET
path: "/v3/vehicle_locations"
---

# List all the vehicles and their locations (v3)

`GET /v3/vehicle_locations`

This API is only meant for vehicles with the Motive Vehicle Gateway. For others, you may use the V1 or V2 API.

## Query parameters

- `vehicle_ids[]` integer[]
- `vehicle_status` string
- `per_page` integer
- `page_no` integer
- `include_aux_details` boolean

## Headers

- `X-Time-Zone` string
- `X-Metric-Units` boolean
- `X-User-Id` integer

## Response `200`

200

- object
  - `vehicles` object[]
    - `vehicle` object
      - `id` integer
      - `number` string
      - `year` string
      - `make` string
      - `model` string
      - `vin` string
      - `aux_status` object
        - `AUX1` object
          - `present` boolean
          - `end_time` string
          - `is_engaged` boolean
          - `start_time` string
          - `aux_equipment_type` string
        - `AUX2` object
          - `present` boolean
          - `end_time` string
          - `is_engaged` boolean
          - `start_time` string
          - `aux_equipment_type` string
      - `current_location` object
        - `lat` number
        - `lon` number
        - `bearing` unknown
        - `located_at` string
        - `city` string
        - `state` string
        - `rg_km` number
        - `rg_brg` number
        - `rg_match` boolean
        - `kph` integer
        - `vehicle_state` string
        - `current_location` string
  - `pagination` object
    - `per_page` integer
    - `page_no` integer
    - `total` integer

---

[API](https://skmtc.net/gomotive/apis/motive.md) · [All operations](https://skmtc.net/gomotive/apis/motive/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gomotive/motive/revisions/c71780e497f5/schema)