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

# IoT Data

> Access and manage vehicle data to enhance connectivity and functionality.

## Overview

The IoT API provides real-time and historical vehicle data, including location tracking, status updates, history, valuations, remote access features, and more.

Integrate seamlessly with automotive commerce operations, leveraging data and AI to enhance vehicle buying and selling processes.

<Accordion title="Use Cases">
  * **Virtual Dealership & Commerce Integrations:**
    Facilitate the complete digital transformation of car sales via connected vehicle data for transparent listings and real-time transaction capabilities on online dealer platforms.
  * **Predictive Maintenance:**
    Get analytics to predict maintenance needs before issues arise, scheduling service proactively to minimize downtime and extend vehicle life.
  * **Insurance Underwriting:**
    Utilize telematics and driver behavior data to create personalized insurance policies, reducing risks and premiums based on actual driving patterns. Usage-based insurance models are a growing demand, leading to new pricing models and risk management solutions.
  * **Pricing & Valuations:**
    Receive competitive purchase offers for a vehicle based on its VIN. Streamline the sale process with real-time valuations.
</Accordion>

| Capabilities                                | Description                                                                                             |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| [Location](#location)                       | Retrieve the current geographical location of the vehicle, detailed by latitude and longitude.          |
| [Odometer](#odometer)                       | Access the vehicle’s current odometer reading, providing insights into vehicle usage.                   |
| [Lock & Unlock](#lock--unlock)              | Control vehicle access remotely by locking or unlocking the doors through the API.                      |
| [EV Battery](#ev-battery)                   | Monitor the battery status of electric vehicles, including the current charge level and range.          |
| [EV Charging](#ev-charging)                 | Manage the charging process of electric vehicles, with commands to start and stop charging.             |
| [Fuel Tank](#fuel-tank)                     | Check the current level of the fuel tank to gauge how much fuel is left and when a refill is necessary. |
| [Tire Pressure](#tire-pressure)             | Obtain real-time data on the tire pressure for each tire, ensuring optimal driving conditions.          |
| [Engine Oil Life](#engine-oil-life)         | Determine the remaining life of the engine oil to plan for necessary maintenance.                       |
| [Vehicle Attributes](#vehicle-attributes)   | Retrieve detailed information about the vehicle, including year, make, model, and options.              |
| [VIN](#vin)                                 | Access the Vehicle Identification Number (VIN) for vehicle identification and registration.             |
| [Instant Firm Offers](#instant-firm-offers) | Obtain real-time firm offers for selling vehicles with just a VIN.                                      |

***

## Location

Retrieve the current geographical location of the vehicle, detailed by latitude and longitude coordinates.

```json theme={null}
{
  "status": "success",
  "data": {
    "latitude": 37.7749,
    "longitude": -122.4194
  }
}
```

***

## Odometer

Access the vehicle’s current odometer reading, providing insights into vehicle usage and maintenance needs.

```json theme={null}
{
  "status": "success",
  "data": {
    "odometer": 50234 // value in miles
  }
}
```

***

## Lock & Unlock

Control vehicle access remotely by locking or unlocking the doors through the API.

```json Lock theme={null}
{
  "status": "success",
  "message": "Vehicle locked successfully."
}
```

```json Unlock theme={null}
{
  "status": "success",
  "message": "Vehicle unlocked successfully."
}
```

***

## EV Battery

Monitor the battery status of electric vehicles, including the current charge level and estimated range.

```json theme={null}
{
  "status": "success",
  "data": {
    "batteryLevel": 80, // percentage of battery level
    "range": 250 // miles vehicle can travel with remaining battery
  }
}
```

***

## EV Charging

Manage the charging process of electric vehicles, with commands to start and stop charging.

```json Start Charging theme={null}
{
  "status": "success",
  "message": "Charging started successfully."
}
```

```json Stop Charging theme={null}
{
  "status": "success",
  "message": "Charging stopped successfully."
}
```

***

## Fuel Tank

Check the current level of the fuel tank to gauge how much fuel is left and when a refill is necessary.

```json theme={null}
{
  "status": "success",
  "data": {
    "fuelLevel": 75 // percentage of fuel tank full
  }
}
```

***

## Tire Pressure

Obtain real-time data on the tire pressure for each tire, helping to ensure optimal driving conditions and safety.

```json theme={null}
{
  "status": "success",
  "data": {
    "frontLeft": 35,
    "frontRight": 35,
    "backLeft": 33,
    "backRight": 33 // pressure in psi
  }
}
```

***

## Engine Oil Life

Determine the remaining life of the engine oil to plan for necessary maintenance and oil changes.

```json theme={null}
{
  "status": "success",
  "data": {
    "oilLife": 60 // percentage of oil life remaining
  }
}
```

***

## Vehicle Attributes

Retrieve detailed information about the vehicle including, year, make, model, year, options, and history reports.

```json theme={null}
{
  "status": "success",
  "data": {
    "make": "Tesla",
    "model": "Model S",
    "year": 2022,
    "options": ["sunroof", "AWD"]
  }
}
```

***

## VIN

Access the Vehicle Identification Number (VIN) for vehicle identification and registration purposes.

```json theme={null}
{
  "status": "success",
  "data": {
    "vin": "1HGBH41JXMN109186"
  }
}
```

***

## Instant Firm Offers

Obtain real-time firm offers for selling vehicles with just a VIN.

```json theme={null}
{
  "vin": "1HGBH41JXMN109186",
  "year": 2022,
  "make": "Tesla",
  "model": "Model S",
  "mileage": 12468,
  "carvanaPrice": 29000,
  "carmaxPrice": 28750,
  "drivewayPrice": 30845,
  ...
}
```