---
title: "Search Vehicles"
method: GET
path: "/v1/vehicles"
tags: ["Vehicle"]
---

# Search Vehicles

`GET /v1/vehicles`

## Query parameters

- `vin` string — Vehicle Identification Number for vehicle
- `imei` string — Unique bouncie device identifier
- `limit` number — Number of search results to limit (for paging)
- `skip` number — Number of search results to skip (for paging)

## Headers

- `Authorization` string — User access token
- `Content-Type` 'application/json'

## Response `200`

Returns an array of vehicles matching the given criteria

- object[]
  - `model` object, required — Make and Model information for the vehicle
    - `make` string, required — Make of the vehicle
    - `name` string, required — Model name of the vehicle
    - `year` number, required — Model year of the vehicle
  - `nickName` string, required — Nickname of the vehicle
  - `standardEngine` string, required — Vehicle engine type
  - `vin` string, required — Vehicle Identification Number for vehicle
  - `imei` string, required — Unique bouncie device identifier
  - `stats` object, required — Vehicle stats
    - `localTimeZone` string, required — Timezone that the vehicle is currenly located
    - `odometer` number, required — Current odometer reading of vehicle
    - `lastUpdated` string, date-time, required — Last time vehicle document was updated
    - `location` object — If available, last known location of vehicle
      - `lat` number, required — Latitude of vehicle
      - `lon` number, required — Longitude of vehicle
      - `heading` number, required — Heading of vehicle
      - `address` string, required — Address of vehicle
    - `fuelLevel` number, required — Percentage of fuel remaining in tank as reported by vehicle
    - `isRunning` boolean, required — Indicates whether the vehicle is currently running
    - `speed` number, required — Current speed of vehicle
    - `mil` object, required — Status of Malfunction Indicator Light (check engine light)
      - `milOn` boolean, required — Whether the MIL is on for the vehicle
      - `lastUpdated` string, date-time, required — Last date that MIL status was updated
      - `qualifiedDtcList` object[], required — List of Diagnostic Trouble Codes (DTCs) for the vehicle
        - `code` string, required — DTC code
        - `name` string[], required — DTC names
      - `battery` object, required — Status of battery for vehicle
        - `status` 'normal' | 'low' | 'critical', required — One of: `normal`, `low`, or `critical`
        - `lastUpdated` string, date-time, required — Last date that battery status was updated

---

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