---
title: "Get Vehicle Range"
method: GET
path: "/v1/vehicles/{vehicle_id}/range"
tags: ["Vehicle Range"]
---

# Get Vehicle Range

`GET /v1/vehicles/{vehicle_id}/range`

Retrieves both nominal and real-world maximum range information for specified vehicles. It enables accurate vehicle
range analysis by drawing on historical data and usage patterns for the specified vehicle.

**Parameters:**
- `vehicle_id`: A unique identifier for the vehicle, which must correspond to a vehicle registered in our system.

**Returns:**
- A vehicle range instance encapsulating detailed range information for the vehicle. The data includes both the
standard (nominal) range and the real (observed) maximum range based on data retrieved directly from the vehicle
and the specifications published by the OEMs.

**Raises:**
- `APIException`: Raised when the system cannot locate the vehicle's range details, due to an invalid 'vehicle_id'
or absence of range data. This results in a 404 Not Found status code.

**Note:**
- The first availability of `real_max_range` depends on the first instance of data retrieved from the vehicle where
the State of Charge is above 40%. As more data is collected, the endpoint is updated on a rolling basis, always
providing the most accurate information available.
- We recommend charging the vehicle to a State of Charge greater than 40% should the endpoint not be available.
- The inclusion of `nominal_max_range` is reliant on the availability of the trim of the vehicle.
- The endpoint's accuracy and availability depend upon the reliability of data sourced from and published by OEMs.


Possible Codes in Error Response (see [Errors](https://docs.volteras.com/api-reference/errors) for error response schema and meaning of codes):

- AUTHENTICATION_ERROR
- REQUEST_VALIDATION_ERROR
- RESOURCE_NOT_FOUND
- SERVER_ERROR

## Path parameters

- `vehicle_id` string, required — Unique internal identifier for the vehicle.

## Response `200`

Successful Response

- ConnectModelsSchemasVehicleVehicleRangeVehicleRange
  - `vehicleId` string, required
  - `unit` string, required
  - `calculationDate` string, date, required
  - `range` RangeDetail, required
    - `real` string, nullable
    - `realWarmerRange` string, nullable
    - `realColderRange` string, nullable
    - `nominal` object, required
    - `score` object, required

---

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