Documentation
Welcome to Vehicle Databases API's Documentation
Electric Vehicle Specifications
GETJSON Response
Overview
An Electric Vehicle Specifications API gives detailed specifications on any electric car. It covers manufacturers from 1999-2024 which have launched electric cars. Apart from basic specifications, dimensions and features, it typically provides data on a range of electric vehicle specifications, including battery capacity, range, charging times and more.
COVERAGE
This API supports US and Canada manufacturers from year 1999 to 2024. Only cars and semi trucks.
SUPPORT
North American region
HTTP Request
Endpoint
GET https://api.vehicledatabases.com/electric-vehicle/{year}/{make}/{model}/{trim}Example — Python / Requests
Target:
Client:
import requests
response = requests.get(
"https://api.vehicledatabases.com/electric-vehicle/{year}/{make}/{model}/{trim}",
headers={"x-authkey": "YOUR_API_KEY"}
)
print(response.json())GET Parameters
| Parameter | Required | Description |
|---|---|---|
| year | ✓ | Vehicle year (e.g. 2006) |
| make | ✓ | Vehicle make (e.g. Dodge) |
| model | ✓ | Vehicle model (e.g. Stratus) |
| trim | ✓ | Vehicle trim (e.g. SXT 4dr Sedan Automatic) |
JSON Response
The response is a JSON of all the information associated with a VIN number. Each vin number has the following elements:
Response Fields
| Parameter | Description |
|---|---|
| status | "success" or "error" |
| data | An object containing all data available. |
Example Response
{
"status": "success",
"data": {
"basic": {
"year": 2023,
"make": "Tesla",
"model": "Model Y",
"trim": "Performance 4Dr ALL Wheel Drive Sport Utility",
"drive_type": "all-wheel",
"transmission": "1 speed automatic",
"recommended_fuel": "Electric"
},
"specs_and_dimension": {
"3rd row headroom:": "879mm (34.6")",
"3rd row hiproom:": "927mm (36.5")",
"3rd row legroom:": "673mm (26.5")",
"3rd row shoulder room:": "1,041mm (41.0")",
"Curb weight:": "2,066kg (4,555lbs)",
"Engine horsepower:": "425hp @ RPM",
"Engine torque:": "475 lb.-ft. @ RPM",
"Exterior body width:": "1,920mm (75.6")",
"Exterior height:": "1,623mm (63.9")",
"Exterior length:": "4,750mm (187.0")",
"Front headroom:": "1,041mm (41.0")",
"Front hiproom:": "1,367mm (53.8")",
"Front legroom:": "1,062mm (41.8")",
"Front shoulder room:": "1,433mm (56.4")",
"GVWR:": "2,591kg (5,712lbs)",
"Interior cargo volume:": "855 L (30 cu.ft.)",
"Interior front cargo volume:": "116 L (4 cu.ft.)",
"Interior maximum cargo volume:": "2,158 L (76 cu.ft.)",
"Rear headroom:": "983mm (38.7")",
"Rear hiproom:": "1,290mm (50.8")",
"Rear legroom:": "1,057mm (41.6")",
"Rear shoulder room:": "1,372mm (54.0")",
"Towing capacity:": "1,588kg (3,500lbs)",
"Turning radius:": "6.1m (19.9')",
"Wheelbase:": "2,891mm (113.8")",
"Max seating capacity": "7",
"Number of doors": "",
"Rear tires": "255/45WR19.0",
"Rear wheel size": "",
"Wheel size": "20"",
"Front tires": "255/45WR19.0"
},
"powertrain": {
"Compressor": "Not Available",
"Drive type": "all-wheel",
"Electric motor 1 torque": "177 lb.-ft.",
"Electric motor 2 torque": "298 lb.-ft.",
"Electric motor horsepower": "184hp @ 6,380RPM",
"Engine location": "front and rear",
"Fuel economy city": "127mpge",
"Fuel economy combined": "122mpge",
"Fuel economy combined (kWh)": "28 kWh/100m",
"Fuel economy equivalent measure": "",
"Fuel economy fuel type": "electric",
"Fuel economy highway": "117mpge",
"Horsepower": "425hp @ RPM",
"Hybrid electric powertrain type": "BEV (battery electric vehicle)",
"Hybrid traction battery all electric range": "330 miles",
"Hybrid traction battery capacity (kWh)": "81",
"Hybrid traction battery charge time (hrs) @ 240V": "11.5",
"Hybrid traction battery DC fast charge connector": "Tesla",
"Hybrid traction battery number of cells": "828",
"Hybrid traction battery onboard charger (kW)": "11.5",
"Hybrid traction battery peak DC fast charge rate (kW)": "250.0",
"Hybrid traction battery peak DC fast charge time (minutes)": "30",
"Hybrid traction battery power output (kW)": "165",
"Hybrid traction battery type": "lithium ion",
"Hybrid traction battery voltage": "350",
"Powertrain number of motors": "2",
"Recommended fuel": "Electric",
"Torque": "475 lb.-ft. @ RPM",
"Transmission": "1 speed automatic"
},
"offroad_capability": {
"Ground clearance (min):": "168mm (6.6")"
},
"features": {
"mechanical_features": [
"Dual Motor: Fr AC Induction/Rr AC Permanent Magnet -inc: 315 mi estimated range",
"3 Skid Plates",
"Gas-Pressurized Shock Absorbers",
"Front Anti-Roll Bar",
"Sport Tuned Suspension",
"Electric Power-Assist Speed-Sensing Steering",
"Double Wishbone Front Suspension w/Coil Springs",
"Multi-Link Rear Suspension w/Coil Springs",
"Lithium Ion Traction Battery w/11.5 kW Onboard Charger, 10 Hrs Charge Time @ 220/240V and 82 kWh Capacity"
],
"exterior_features": [
"Wheels: 20" x 9.0" Uberturbine",
"Clearcoat Paint",
"Fixed Laminated Glass 1st Row Sunroof",
"Fixed Laminated Glass 2nd Row Sunroof",
"Body-Colored Front Bumper",
"Body-Colored Rear Bumper",
"Black Side Windows Trim",
"Black Door Handles",
"Body-Colored Power w/Tilt Down Heated Auto Dimming Side Mirrors w/Power Folding",
"Fixed Rear Window w/Defroster",
"Light Tinted Glass",
"Rain Detecting Variable Intermittent Wipers w/Heated Wiper Park",
"Galvanized Steel/Aluminum Panels",
"Lip Spoiler",
"Power Open And Close Trunk Rear Cargo Access",
"Tailgate/Rear Door Lock Included w/Power Door Locks",
"Auto On/Off Projector Beam Led Low/High Beam Daytime Running Auto-Leveling Auto High-Beam Headlamps w/Delay-Off",
"Perimeter/Approach Lights",
"LED Brakelights",
"Headlights-Automatic Highbeams",
"Front Fog Lamps",
"Laminated Glass",
"255/45WR19.0"
],
"entertainment_features": [
"Radio: Premium Audio System -inc: 13 speakers, 1 subwoofer, 2 amps, immersive sound feature, music and media over Bluetooth, USB-A port in the glovebox w/a 128GB portable storage device and 4 USB-C ports and wireless charging for 2 smartphones in center console, Standard connectivity is included, at no additional cost, for 8 years following the new vehicle's original delivery, Certain high data usage vehicle features require at least standard connectivity, including maps, navigation and voice commands, Premium connectivity (including navigation, live traffic visualization, satellite-view maps, video streaming, caraoke, music streaming, internet browser) is complimentary for 30 days, then available as a subscription Features subject to change and may vary based on hardware configuration. New features that become available after delivery may be subject to additional charges.",
"Radio w/Seek-Scan, Clock, Steering Wheel Controls, Voice Activation, Radio Data System and 128 Gb Internal Memory",
"Window Grid Antenna",
"14 Performance Speakers",
"Regular Amplifier",
"1 LCD Monitor In The Front",
"Entertainment System w/Digital Media",
"Real-Time Traffic Display"
],
"interior_features": [
"Heated Front Bucket Seats -inc: power adjustable front seats and custom driver profiles",
"Front Seats w/Power 4-Way Driver Lumbar",
"8-Way Driver Seat -inc: Power 4-Way Lumbar Support",
"8-Way Passenger Seat",
"60-40 Folding Bench Front Facing Heated Fold Forward Seatback Leatherette Rear Seat",
"Power Tilt/Telescoping Steering Column",
"Gauges -inc: Speedometer, Odometer, Traction Battery Level, Power/Regen, Trip Odometer and Trip Computer",
"Power Rear Windows",
"Mobile Hotspot Internet Access",
"Heated Leatherette Steering Wheel",
"Front Cupholder",
"Rear Cupholder",
"Compass",
"Proximity x-authkey For Doors And Power On",
"Valet Function",
"Remote Keyless Entry w/Integrated x-authkey Transmitter, 4 Door Curb/Courtesy and Illuminated Entry",
"Remote Releases -Inc: Power Cargo Access and Power Charge Port Door",
"Cruise Control w/Steering Wheel Controls",
"Distance Pacing w/Traffic Stop-Go",
"Dual Zone Front Automatic Air Conditioning w/Steering Wheel Controls",
"HVAC -inc: Console Ducts",
"Illuminated Locking Glove Box",
"Driver Foot Rest",
"Interior Trim -inc: Aluminum/Genuine Wood Instrument Panel Insert, Metal-Look Console Insert and Metal-Look Interior Accents",
"Full Cloth Headliner",
"Simulated Suede Door Trim Insert",
"Premium Seat Trim",
"Day-Night Auto-Dimming Rearview Mirror",
"Driver And Passenger Visor Vanity Mirrors w/Driver And Passenger Illumination, Driver And Passenger Auxiliary Mirror",
"Full Floor Console w/Covered Storage and 1 12V DC Power Outlet",
"Front And Rear Map Lights",
"Fade-To-Off Interior Lighting",
"Carpet Floor Trim",
"Full Carpet Floor Covering -inc: Carpet Front And Rear Floor Mats",
"Cargo Area Concealed Storage",
"Cargo Space Lights",
"Memory Settings -inc: Door Mirrors, Steering Wheel, Audio and HVAC",
"FOB Controls -inc: Cargo Access and Windows",
"Tracker System",
"Smart Device Integration",
"Instrument Panel Covered Bin, Driver / Passenger And Rear Door Bins",
"Power 1st Row Windows w/Front And Rear 1-Touch Up/Down",
"Delayed Accessory Power",
"Power Door Locks w/Autolock Feature",
"Systems Monitor",
"Trip Computer",
"Outside Temp Gauge",
"Digital Appearance",
"Fixed Front Head Restraints and Fixed Rear Head Restraints",
"Front Center Armrest and Rear Center Armrest",
"2 Seatback Storage Pockets",
"Immobilizer",
"1 12V DC Power Outlet",
"Air Filtration"
],
"safety_features": [
"Electronic Stability Control (ESC)",
"ABS And Driveline Traction Control",
"Side Impact Beams",
"Dual Stage Driver And Passenger Seat-Mounted Side Airbags",
"Front And Rear Parking Sensors",
"Blind Spot",
"Forward Collision Mitigation and Rear Collision Warning",
"Lane Keeping Assist",
"Lane Departure Warning",
"Aerial View Camera System",
"Collision Mitigation-Front",
"Driver Monitoring-Alert",
"Tire Specific Low Tire Pressure Warning",
"Dual Stage Driver And Passenger Front Airbags",
"Curtain 1st And 2nd Row Airbags",
"Airbag Occupancy Sensor",
"Driver And Passenger Knee Airbag",
"Restricted Driving Mode",
"Power Rear Child Safety Locks",
"Outboard Front Lap And Shoulder Safety Belts -inc: Rear Center 3 Point, Height Adjusters and Pretensioners",
"Back-Up Camera",
"Front Camera",
"Left Side Camera",
"Right Side Camera"
]
}
}
}Error Responses
error
statusWhen an error occurs, the API returns an error status with a code and message.
| Code | Description | Resolution |
|---|---|---|
| 400 | Record(s) were not found for this vehicle. | Verify the VIN is correct or try a different vehicle. |
| 401 | Invalid API Key | Check your API key for correctness and ensure it is properly formatted. |
| 403 | Rate limit exceeded | You have exceeded the number of allowed requests in a given time period. Please wait and try again. |
| 422 | Validation error | One or more parameters are invalid. Check the request parameters for correctness. |
| 500 | Internal server error | An unexpected error occurred on the server. Please try again later or contact support. |