Vehicle API Specifications

Browse all specifications and sample JSON responses from CarAPIs vehicle API. You can also navigate the API using Swagger or Redoc. Be sure to check out our API documentation for information on rate limiting, authentication, advanced search operators and more.

Test Drive the API
View Pricing

Year, Make, Model and Trim API
Vehicle Bodies API
Vehicle Engines API
Vehicle Mileage API
Interior and Exterior Colors API
Vehicle Identification Number (VIN) Lookup API

Vehicle Year, Make, Model and Trim API

Read the full documentation here. You can also request this data separately through the year, make and model specific endpoints.

Property	Description
year integer	Vehicle Year https://schema.org/modelDate
name string	Vehicle Trim https://schema.org/name
description string	Full trim description https://schema.org/Text
msrp integer	Manufacturers Suggested Retail Price https://schema.org/Number
invoice integer	The typical auto dealers cost https://schema.org/Number

Sample JSON Car API Response:

                                
{
  "year": 2020,
  "name": "S",
  "description": "S 4dr SUV AWD (2.0L 4cyl 6A)",
  "msrp": 21590,
  "invoice": 21159,
  "make_model": {
    "name": "EcoSport",
    "make": {
      "name": "Ford"
    }
  }
}

Vehicle Body API

Read the full documentation here.

Property	Description
type string	The body type, such as SUV or Sedan https://schema.org/bodyType Enum: Cargo Van, Convertible, Coupe, Ext Cargo Minivan, Ext Cargo Van, Ext Minivan, Ext Van, Hatchback, Minivan, Passenger Van, Sedan, SUV, Truck (Access Cab), Truck (Cab Plus), Truck (Club Cab), Truck (Crew Cab), Truck (CrewMax), Truck (Double Cab), Truck (Extended Cab), Truck (King Cab), Truck (Mega Cab), Truck (Quad Cab), Truck (Regular Cab), Truck (SuperCab), Truck (SuperCrew), Truck (Xtracab), Unknown, Van, Wagon
doors integer	Number of doors — generally including a hatchback as an additional door https://schema.org/numberOfDoors
seats integer	Number of passenger seats in the vehicle. https://schema.org/seatingCapacity
length number	Total length (in inches) of the vehicle in inches https://schema.org/depth
height number	Total height (in inches) of the vehicle https://schema.org/height
width number	Total width (in inches) of the vehicle https://schema.org/width
wheel_base number	The horizontal distance (in inches) between the centers of the front and rear wheels https://schema.org/wheelbase
front_track number	The distance (in inches) between the centerline of the wheels https://schema.org/Number
rear_track number	The distance (in inches) between the hub flanges on an axle https://schema.org/Number
ground_clearance number	The distance (in inches) between the lowest point on the undersurface of the vehicle and the road https://schema.org/Number
cargo_capacity number	The standard total cubic feet of space in a vehicles cargo area https://schema.org/Number
max_cargo_capacity number	The maximum total cubic feet of space in a vehicles cargo area https://schema.org/Number
curb_weight integer	Curb weight refers to the vehicles heaviness (in pounds) without passengers or cargo, only counting the car itself along with necessary fluids like oil and coolant https://schema.org/Number
gross_weight integer	Gross weight (in pounds) considers all components—including passengers, cargo, and both the tow vehicle weight—if one is attached https://schema.org/weight
max_payload integer	Maximum weight in pounds that a vehicle can safely carry https://schema.org/Number
max_towing_capacity integer	Maximum weight in pounds that a vehicle can safely tow https://schema.org/weight

Sample Car Body JSON API Response:

                                
{
  "type": "SUV",
  "doors": 5,
  "length": "161.3",
  "width": "69.5",
  "seats": 5,
  "height": "65.1",
  "wheel_base": "99.2",
  "front_track": null,
  "rear_track": null,
  "ground_clearance": null,
  "cargo_capacity": "20.0",
  "max_cargo_capacity": null,
  "curb_weight": 3300,
  "gross_weight": null,
  "max_payload": 1570,
  "max_towing_capacity": null
}

Vehicle Engine API

Read the full documentation here.

Property	Description
engine_type string	Type of engine https://schema.org/engineType Enum: diesel, electric, electric (fuel cell), flex-fuel (FFV), gas, hybrid, mild hybrid, natural gas (CNG), plug-in hybrid
fuel_type string	The fuel the vehicle uses https://schema.org/fuelType Enum: diesel fuel, electric, flex-fuel (premium unleaded recommended/E85), flex-fuel (premium unleaded required/E85), flex-fuel (unleaded/E85), flex-fuel (unleaded/natural gas), hydrogen, midgrade unleaded (recommended), natural gas, premium unleaded (recommended), premium unleaded (required), regular unleaded
cylinders string	How many cylinders the engine has https://schema.org/Number Enum: flat 4, flat 6, I2, I3, I4, I5, I6, rotary 0, V10, V12, V6, V8, W12, W16, W8
size number	Total size of the engine in liters https://schema.org/Number
horsepower_hp integer	One horsepower equals 33,000 foot-pounds of work per minute https://schema.org/enginePower
horsepower_rpm integer	https://schema.org/Number
torque_ft_lbs integer	The torque (turning force) of the vehicle's engine. https://schema.org/torque
torque_rpm integer	https://schema.org/torque
valves integer	Number of valves. The valves are installed in a part of the engine called the head and are responsible for letting air and/or fuel into the cylinders to be combusted -- those are called intake valves -- and for letting the exhaust from that combustion out of the cylinders -- those are called exhaust valves. https://schema.org/Number
valve_timing string	In a piston engine, the valve timing is the precise timing of the opening and closing of the valves. https://schema.org/Number Enum: Variable
cam_type string	Camshafts are integral components of internal combustion engines, responsible for controlling the opening and closing of the engine's intake and exhaust valves. https://schema.org/Text Enum: Double overhead cam (DOHC), Overhead valves (OHV), Single overhead cam (SOHC)
drive_type string	The drive type which delivers power to the wheels. https://schema.org/Text Enum: all wheel drive, four wheel drive, front wheel drive, rear wheel drive
transmission string	Type of transmission https://schema.org/Text Enum: 1-speed direct drive, 10-speed automatic, 10-speed shiftable automatic, 2-speed, 2-speed automatic, 3-speed automatic, 4-speed automatic, 4-speed manual, 4-speed shiftable automatic, 5-speed automated manual, 5-speed automatic, 5-speed manual, 5-speed shiftable automatic, 6-speed automated manual, 6-speed automatic, 6-speed manual, 6-speed shiftable automatic, 7-speed automated manual, 7-speed automatic, 7-speed manual, 7-speed shiftable automatic, 8-speed automated manual, 8-speed automatic, 8-speed shiftable automatic, 9-speed automated manual, 9-speed automatic, 9-speed shiftable automatic, continuously variable-speed automatic, continuously variable-speed shiftable automatic, electrically variable-speed automatic

Sample Car Engine JSON REST API Response:

                                
{
  "engine_type": "gas",
  "fuel_type": "regular unleaded",
  "cylinders": "I4",
  "size": "5.0",
  "horsepower_hp": 166,
  "horsepower_rpm": 6500,
  "torque_ft_lbs": 149,
  "torque_rpm": 4500,
  "valves": 16,
  "valve_timing": "Variable",
  "cam_type": "Double overhead cam (DOHC)",
  "drive_type": "all wheel drive",
  "transmission": "6-speed shiftable automatic"
}

Vehicle Mileage API

Read the full documentation here.

Property	Description
fuel_tank_capacity number	How much fuel the vehicle holds (gallons) https://schema.org/fuelCapacity
combined_mpg integer	Combined fuel economy is a weighted average of City and Highway MPG values that is calculated by weighting the City value by 55% and the Highway value by 45%. https://schema.org/fuelEfficiency
epa_city_mpg integer	Miles per gallon for city driving https://schema.org/Number
epa_highway_mpg integer	Miles per gallon for highway driving https://schema.org/Number
range_city integer	Total range in miles on a full tank for city driving https://schema.org/Number
range_highway integer	Total range in miles on a full tank for highway driving https://schema.org/Number
epa_combined_mpg_electric integer	MPG equivalent for electric vehicles https://schema.org/Number
epa_city_mpg_electric integer	MPG equivalent for driving electric vehicles in the city https://schema.org/Number
epa_highway_mpg_electric integer	MPG equivalent for driving electric vehicles on the highway https://schema.org/Number
range_electric integer	Range for electric vehicles in miles https://schema.org/Number
epa_kwh_100_mi_electric integer	kWh used to drive 100 miles for an electric vehicle https://schema.org/Number
epa_time_to_charge_hr_240v_electric number	How long it takes to charge an EV battery https://schema.org/Number
battery_capacity_electric integer	Total capacity of the battery kWh https://schema.org/Number

Sample Car Mileage JSON REST API Response:

                                
{
  "fuel_tank_capacity": "13.8",
  "combined_mpg": 25,
  "epa_city_mpg": 23,
  "epa_highway_mpg": 29,
  "range_city": 317,
  "range_highway": 400
  "battery_capacity_electric": null,
  "epa_time_to_charge_hr_240v_electric": null,
  "epa_kwh_100_mi_electric": null,
  "range_electric": null,
  "epa_highway_mpg_electric": null,
  "epa_city_mpg_electric": null,
  "epa_combined_mpg_electric": null
}

Vehicle Colors API

Read the full exterior colors and interior colors documentation.

Property	Description
name string	Color and shade https://schema.org/color
rgb string	Red, Green, Blue (RGB) value https://schema.org/Text

Sample Car Colors JSON REST API Response:

                                
{
  "name": "Moondust Silver Metallic",
  "rgb": "199,200,203"
}

VIN Lookup API

Read the full VIN decoder documentation.

Vehicle API Specification

Vehicle Year, Make, Model and Trim API

Vehicle Body API

Vehicle Engine API

Vehicle Mileage API

Vehicle Colors API

VIN Lookup API

Start developing today, no fees, no signup