Vehicle API Specification

A detailed breakdown of the automotive API data offered by Car API.

Browse all specifications and sample JSON responses from CarAPIs vehicle API. You can also navigate the API using Swagger or Redoc.

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 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), Van, Wagon
doors
integer
Number of doors — generally including a hatchback as an additional door
https://schema.org/seatingCapacity
seats
integer
Number of passenger doors on the vehicle.
https://schema.org/numberOfDoors
length
number
Total length of the vehicle
https://schema.org/depth
height
number
Total height of the vehicle
https://schema.org/height
width
number
Total width of the vehicle
https://schema.org/width
wheel_base
number
The horizontal distance between the centers of the front and rear wheels.
https://schema.org/wheelbase
front_track
number
The distance between the centerline of the wheels
https://schema.org/Number
rear_track
number
The distance between the hub flanges on an axle
https://schema.org/Number
ground_clearance
number
The distance between the lowest point on the undersurface of the vehicle and the road
https://schema.org/Number
cargo_capacity
number
The total cubic feet of space in a vehicles cargo area
https://schema.org/Number
max_cargo_capacity
number
https://schema.org/Number
curb_weight
integer
https://schema.org/Number
gross_weight
integer
https://schema.org/weight
max_payload
integer
https://schema.org/Number
max_towing_capacity
integer
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, natural gas, premium unleaded (recommended), premium unleaded (required), regular unleaded
cylinders
string
How many cylinders the engine has
https://schema.org/Number
Enum: fla, I2, I3, I4, I5, I6, rot, V10, V12, V6, V8, W12, W16, W8
size
number
Total size of the engine
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
https://schema.org/torque
torque_rpm
integer
https://schema.org/torque
valves
integer
Number of valves
https://schema.org/Number
valve_timing
string
https://schema.org/Number
Enum: Variable
cam_type
string
https://schema.org/Text
Enum: Double overhead cam (DOHC), Overhead valves (OHV), Single overhead cam (SOHC)
drive_type
string
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 automated manual, 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 on a full tank for city driving
https://schema.org/Number
range_highway
integer
Total range on a full tank for highway driving
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
}
                                
                            

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"
}
                                
                            

Start developing today, no fees, no signup

CarAPI is developer friendly. Only pay when you're ready to go live. CarAPIs free vehicle set requires no account.