> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargeapi.co/llms.txt
> Use this file to discover all available pages before exploring further.

# The Vehicle Telemetry object

<div className="xl:hidden">
  <CodeGroup>
    ```json The Vehicle Telemetry object theme={null}
    {
        "id": "vtel_QqrK9N8ew14uY0Qi7gHlQD0vWQ48hdBP",
        "object": "vehicle_telemetry",
        "battery": {
            "capacity": 82000,
            "level": 78,
            "range": 320000,
            "status": "charging",
            "temperature": 24.5,
            "updated": "2026-04-01T01:34:31.737Z"
        },
        "firmware_version": "v1.2.3",
        "location": {
            "latitude": 48.8698,
            "longitude": 2.3319,
            "updated": "2026-04-01T01:34:40.112Z"
        },
        "odometer": {
            "unit": "KMS",
            "updated": "2026-04-01T01:34:34.348Z",
            "value": 32540
        },
        "vehicle": "veh_eDmko7kTu3LBcfLJ3E5QslrtSRvbsyOZ"
    }
    ```
  </CodeGroup>
</div>

<div className="hidden xl:block">
  <ResponseExample>
    ```json The Vehicle Telemetry object theme={null}
    {
        "id": "vtel_QqrK9N8ew14uY0Qi7gHlQD0vWQ48hdBP",
        "object": "vehicle_telemetry",
        "battery": {
            "capacity": 82000,
            "level": 78,
            "range": 320000,
            "status": "charging",
            "temperature": 24.5,
            "updated": "2026-04-01T01:34:31.737Z"
        },
        "firmware_version": "v1.2.3",
        "location": {
            "latitude": 48.8698,
            "longitude": 2.3319,
            "updated": "2026-04-01T01:34:40.112Z"
        },
        "odometer": {
            "unit": "KMS",
            "updated": "2026-04-01T01:34:34.348Z",
            "value": 32540
        },
        "vehicle": "veh_eDmko7kTu3LBcfLJ3E5QslrtSRvbsyOZ"
    }
    ```
  </ResponseExample>
</div>

This object represents vehicle telemetry in Charge. It provides near-real-time battery, range, location, firmware, and odometer data for a connected vehicle.

## Attributes

<ResponseField name="id" type="string">
  Unique identifier for the object.
</ResponseField>

<ResponseField name="battery" type="object">
  Battery telemetry for the vehicle.

  <Expandable title="properties">
    <ResponseField name="capacity" type="integer | null">
      Battery capacity in watt-hours (Wh).
    </ResponseField>

    <ResponseField name="level" type="integer">
      Battery charge level as a percentage (0–100).
    </ResponseField>

    <ResponseField name="range" type="integer">
      Estimated remaining driving range in meters.
    </ResponseField>

    <ResponseField name="status" type="string">
      Charging status.
    </ResponseField>

    <ResponseField name="temperature" type="number | null">
      Measured battery temperature in Celsius.
    </ResponseField>

    <ResponseField name="updated" type="string">
      Time at which the battery telemetry was last updated. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="location" type="object">
  Current geographic position of the vehicle.

  <Expandable title="properties">
    <ResponseField name="latitude" type="number">
      Latitude component of the GPS position.
    </ResponseField>

    <ResponseField name="longitude" type="number">
      Longitude component of the GPS position.
    </ResponseField>

    <ResponseField name="updated" type="string">
      Time at which the location was last updated. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="odometer" type="object">
  Most recent odometer reading reported by the vehicle.

  <Expandable title="properties">
    <ResponseField name="unit" type="string">
      Unit of measurement for the odometer value.

      Available options: `KMS`, `MILES`
    </ResponseField>

    <ResponseField name="updated" type="string">
      Time at which the odometer was last updated. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
    </ResponseField>

    <ResponseField name="value" type="integer">
      Total distance driven by the vehicle.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="vehicle" type="string" post={[<Tooltip tip="This can be expanded into an object with the expand request parameter."><a href="/expand" className="charge-expandable-label">Expandable</a></Tooltip>]}>
  ID of the vehicle this telemetry data belongs to.
</ResponseField>

## More attributes

<ResponseField name="object" type="string">
  String representing the object's type.
</ResponseField>

<ResponseField name="firmware_version" type="string">
  Firmware version currently running on the vehicle.
</ResponseField>