Get Vehicle 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 for error response schema and meaning of codes):

• AUTHENTICATION_ERROR
• REQUEST_VALIDATION_ERROR
• RESOURCE_NOT_FOUND
• SERVER_ERROR