---
title: "Get Idles"
method: GET
path: "/{vin}/idles"
tags: ["Vehicle Data"]
---

# Get Idles

`GET /{vin}/idles`

Returns the idles for a vehicle.

A vehicle is considered idle if not driving or charging.

## Query parameters

- `distance_format` 'mi' | 'km'
- `format` 'json' | 'csv'
- `timezone` string
- `from` number
- `to` number
- `origin_latitude` number
- `origin_longitude` number
- `origin_radius` number
- `exclude_origin` boolean
- `limit` number

## Response `200`

Success

- object
  - `results` Idle[]
    - `id` number, required
    - `started_at` number, required
    - `ended_at` number, required
    - `location` string, required
    - `latitude` number, required
    - `longitude` number, required
    - `starting_battery` number, required
    - `ending_battery` number, required
    - `rated_range_used` number, required
    - `climate_fraction` number, required
    - `sentry_fraction` number, required
    - `energy_used` number, required

---

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