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.

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

    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 our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

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
[
    {
      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

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

Sample Request Live Demo!

year

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

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

Headers

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

Sample Response

JSON
[
    "...",
    "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

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

Sample Request

make
year

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

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
[
    "Model 3",
    "Model 3 Long Range Dual Motor",
    "Model 3 Long Range Performance",
    "..."
]

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.