NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

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.

Online
(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

3 endpoints

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. Supports partial matching (e.g. Model matches Model 3, Model Y, etc.).

  • 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

A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.

  • make

    Manufacturer name (for example Tesla).

  • model

    Model name (for example Model 3).

  • year_start

    First model year this configuration is available.

  • battery_capacity  Premium only

    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).

  • top_speed  Premium only

    Top speed in km/h (for example 201 km/h).

  • electric_range  Premium only

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

  • total_power

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

  • vehicle_consumption  Premium only

    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).

Live Demo

Live demo · no API key required
Query parameters
make
model
min_year
max_year
min_range

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/electricvehicle?make=Tesla&model=Model%203
Sample response
[
{
"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

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.

Business tier and above, or any annual plan

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

A JSON array of strings, or an error if the request is unsuccessful.

Live Demo

Live demo · no API key required
Query parameters
year

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/electricvehiclemakes
Sample response
[
"...",
"Tesla",
"Toyota",
"Vinfast",
"..."
]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/electricvehiclemakes" \ -H "X-Api-Key: YOUR_API_KEY"

Business tier and above, or any annual plan

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

A JSON array of strings, or an error if the request is unsuccessful.

Live Demo

Live demo · no API key required
Query parameters
make
year

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/electricvehiclemodels?make=Tesla
Sample response
[
"Model 3",
"Model 3 Long Range Dual Motor",
"Model 3 Long Range Performance",
"..."
]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/electricvehiclemodels?make=Tesla" \ -H "X-Api-Key: YOUR_API_KEY"

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Electric Vehicle API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • Each object from the /v1/electricvehicle endpoint includes battery fields such as battery_capacity and battery_useable_capacity (both in kWh), charging fields like charge_power (AC, e.g. 11 kW AC) and charge_power_max (DC fast charging, e.g. 170 kW DC), plus electric_range, total_power, vehicle_consumption, and body specs like length, width, height, and seats. For physical charging station locations rather than per-vehicle charging specs, see the EV Charger API.
  • Call /v1/electricvehicle with at least one parameter other than limit and offset, such as make (e.g. tesla), model (which supports partial matching, so Model matches Model 3 and Model Y), or range and year filters like min_year, max_year, min_range, and max_range. Each request needs your X-Api-Key header, which you can obtain after you create an account.
  • /v1/electricvehiclemakes returns a JSON array of all EV manufacturers (optionally filtered by year), and /v1/electricvehiclemodels returns all models for a given make (also optionally filtered by year); both require a Business, Professional, or annual subscription, which you can review on the pricing page. These help you build dropdowns and discover valid make and model values before calling the main vehicle endpoint.
  • No, this API is limited to electric vehicles and their EV-specific datapoints like battery_capacity, charge_power_max, and vehicle_consumption. For specs on conventional and non-EV vehicles use the Cars API, or decode a specific vehicle by its VIN with the VIN Lookup API.

Explore API integration use cases for recommended APIs and workflow examples.