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

## Request

- Base URL: `https://api.gomotive.com`
- URL: `https://api.gomotive.com/v3/vehicle_locations`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/gomotive/apis/motive/docs/v3/vehicle_locations/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/gomotive/apis/motive.md) - [All operations](https://skmtc.dev/gomotive/apis/motive/llms.txt) - [OpenAPI document](https://skmtc.dev/gomotive/apis/motive/revisions/c71780e497f5?raw)