Holiday Sale! Get over 30% off when you subscribe to an annual plan!

Electric Vehicle API

The Electric Vehicle API provides dozens of detailed datapoints on electric vehicles including range, battery capacity, charging time and performance metrics.

Available endpoints:

For non-EV-specific data on all cars, see the Cars API.

(4.6)

From 3,156 users

4,100+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
300ms311ms385ms703ms1184ms

Didn't find what you were looking for? Suggest an improvement

/v1/electricvehicle GET

https://api.api-ninjas.com/v1/electricvehicle

Get electric vehicle data from given parameters. Returns a list of electric vehicles that satisfy the parameters.

Parameters

At least one parameter (other than limit and offset) is required.

  • make  optional

    Vehicle manufacturer (e.g. tesla or nissan).

  • model  optional

    Vehicle model (e.g. model3 or leaf).

  • min_year  optional

    Minimum vehicle model year (e.g. 2020).

  • max_year  optional

    Maximum vehicle model year (e.g. 2023).

  • min_range  optional

    Minimum range in kilometers (e.g. 250).

  • max_range  optional

    Maximum range in kilometers (e.g. 400).

  • limit  optional premium only

    How many results to return. Must be between 1 and 10. Default is 1.

  • offset  optional premium only

    Number of results to skip. Used for pagination. Default is 0.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Returns an array of electric vehicle objects. Each object contains many technical fields; key fields include:

  • make

    Manufacturer name (for example Tesla).

  • model

    Model name (for example Model 3).

  • year_start

    First model year this configuration is available.

  • battery_capacity

    Nominal battery capacity in kWh (for example 60.0 kWh).

  • battery_useable_capacity

    Usable battery capacity in kWh.

  • charge_power

    AC charging power rating (for example 11 kW AC).

  • charge_power_max

    Maximum DC fast-charging power (for example 170 kW DC).

  • electric_range

    Rated electric range in kilometers (for example 420 km).

  • total_power

    Total drivetrain power (for example 208 kW (283 PS)).

  • vehicle_consumption

    Energy consumption in Wh/km (for example 112 Wh/km).

  • length, width, height

    Exterior dimensions in millimeters.

  • seats

    Seating capacity (for example 5 people).

Additional fields provide more detailed battery, charging, performance, and body specifications (see sample response).

Sample Request Live Demo!

make
model
min_year
max_year
min_range

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/electricvehicle?make=Tesla&model=Model%203

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 [ { "make": "Tesla", "model": "Model 3", "year_start": "2023", "battery_capacity": "60.0 kWh", "battery_type": "Lithium-ion", "battery_number_of_cells": "106", "battery_architecture": "400 V", "battery_useable_capacity": "57.5 kWh", "battery_cathode_material": "LFP", "battery_pack_configuration": "106s1p", "battery_voltage": "340 V", "battery_form_factor": "Prismatic", "battery_name": "CATL LFP60", "charge_port": "CCS", "charge_port_location": "Left Side - Rear", "charge_power": "11 kW AC", "charge_speed": "730 km/h", "charge_power_max": "170 kW DC", "charge_power_10p_80p": "108 kW DC", "autocharge_supported": "Yes", "plug_charge_supported": "No", "supported_charging_protocol": "-", "preconditioning_possible": "Yes", "acceleration_0_100_kmh": "6.1 sec", "top_speed": "201 km/h", "electric_range": "420 km", "total_power": "208 kW (283 PS)", "total_torque": "420 Nm", "drive": "Rear", "vehicle_consumption": "112 Wh/km", "co2_emissions": "0 g/km", "vehicle_fuel_equivalent": "1.3 l/100km", "rated_consumption": "No Data", "rated_fuel_equivalent": "No Data", "energy_consumption_city_cold_weather": "149 Wh/km", "energy_consumption_highway_cold_weather": "189 Wh/km", "energy_consumption_combined_cold_weather": "167 Wh/km", "energy_consumption_city_mild_weather": "93 Wh/km", "energy_consumption_highway_mild_weather": "142 Wh/km", "energy_consumption_combined_mild_weather": "116 Wh/km", "length": "4720 mm", "width": "1849 mm", "width_with_mirrors": "2089 mm", "height": "1441 mm", "wheelbase": "2875 mm", "gross_vehicle_weight": "2200 kg", "max_payload": "439 kg", "cargo_volume": "594 L", "cargo_volume_frunk": "88 L", "seats": "5 people", "turning_circle": "No Data", "platform": "TESLA 3/Y", "car_body": "Sedan", "segment": "D - Large" } ]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/electricvehicle?make=Tesla&model=Model%203" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

/v1/electricvehiclemakes GET

Business, Professional, or annual subscriptions only only

https://api.api-ninjas.com/v1/electricvehiclemakes

Returns a list of all electric vehicle makes (manufacturers).

Parameters

  • year  optional

    Filter manufacturers by year (e.g. 2023).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Returns an array of electric vehicle makes as strings (for example "Tesla", "Toyota").

Sample Request Live Demo!

year

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/electricvehiclemakes

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 7 [ "...", "Tesla", "Toyota", "Vinfast", "..." ]

/v1/electricvehiclemodels GET

Business, Professional, or annual subscriptions only only

https://api.api-ninjas.com/v1/electricvehiclemodels

Returns a list of all electric vehicle models for a given make (manufacturer).

Parameters

  • make  required

    Vehicle manufacturer (e.g. tesla).

  • year  optional

    Vehicle model year (e.g. 2023).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Returns an array of electric vehicle model names as strings (for example "Model 3", "Model 3 Long Range Dual Motor").

Sample Request

make
year

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/electricvehiclemodels?make=Tesla

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 [ "Model 3", "Model 3 Long Range Dual Motor", "Model 3 Long Range Performance", "..." ]