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.
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"
}
}
}
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), 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
}
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: 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"
}
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
}
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"
}
Read the full VIN decoder documentation.
Sample VIN Decoder JSON REST API Response:
{
"year": 2022,
"make": "KIA",
"model": "Soul",
"trim": "LX, S, X Line",
"specs": {
"suggested_vin": "",
"possible_values": "",
"vehicle_descriptor": "KNDJ23AU*N7",
"destination_market": null,
"manufacturer_name": "HYUNDAI-KIA AMERICA TECHNICAL CENTER INC (HATCI)",
"plant_city": "GWANG-JU",
"series": null,
"vehicle_type": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
"plant_country": "SOUTH KOREA",
"plant_company_name": null,
"plant_state": null,
"trim2": null,
"series2": "Wagon Body Style",
"note": null,
"base_price": null,
"non_land_use": null,
"body_class": "Sport Utility Vehicle (SUV)/Multi-Purpose Vehicle (MPV)",
"doors": null,
"windows": null,
"wheel_base_type": null,
"track_width_inches": null,
"gross_vehicle_weight_rating_from": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)",
"bed_length_inches": null,
"curb_weight_pounds": null,
"wheel_base_inches_from": null,
"wheel_base_inches_to": null,
"gross_combination_weight_rating_from": null,
"gross_combination_weight_rating_to": null,
"gross_vehicle_weight_rating_to": null,
"bed_type": null,
"cab_type": null,
"trailer_type_connection": "Not Applicable",
"trailer_body_type": "Not Applicable",
"trailer_length_feet": null,
"other_trailer_info": null,
"number_of_wheels": null,
"wheel_size_front_inches": null,
"wheel_size_rear_inches": null,
"entertainment_system": null,
"steering_location": null,
"number_of_seats": "5",
"number_of_seat_rows": "2",
"transmission_style": null,
"transmission_speeds": null,
"drive_type": "4x2",
"axles": null,
"axle_configuration": null,
"brake_system_type": null,
"brake_system_description": null,
"other_battery_info": null,
"battery_type": null,
"number_of_battery_cells_per_module": null,
"battery_current_amps_from": null,
"battery_voltage_volts_from": null,
"battery_energy_kwh_from": null,
"ev_drive_unit": null,
"battery_current_amps_to": null,
"battery_voltage_volts_to": null,
"battery_energy_kwh_to": null,
"number_of_battery_modules_per_pack": null,
"number_of_battery_packs_per_vehicle": null,
"charger_level": null,
"charger_power_kw": null,
"engine_number_of_cylinders": "4",
"displacement_cc": "2000.0",
"displacement_ci": "122.04748818946",
"displacement_l": "2.0",
"engine_stroke_cycles": null,
"engine_model": "MPI NU",
"engine_power_kw": "109.6179",
"fuel_type_primary": "Gasoline",
"valve_train_design": "Dual Overhead Cam (DOHC)",
"engine_configuration": null,
"fuel_type_secondary": null,
"fuel_delivery_fuel_injection_type": "Multipoint Fuel Injection (MPFI)",
"engine_brake_hp_from": "147",
"cooling_type": null,
"engine_brake_hp_to": null,
"electrification_level": null,
"other_engine_info": null,
"turbo": null,
"top_speed_mph": null,
"engine_manufacturer": "KMC",
"pretensioner": null,
"seat_belt_type": "Manual",
"other_restraint_system_info": "Seat Belt: All Positions",
"curtain_air_bag_locations": "1st and 2nd Rows",
"seat_cushion_air_bag_locations": null,
"front_air_bag_locations": "1st Row (Driver and Passenger)",
"knee_air_bag_locations": null,
"side_air_bag_locations": "1st Row (Driver and Passenger)",
"anti_lock_braking_system_abs": "Standard",
"electronic_stability_control_esc": "Standard",
"traction_control": "Standard",
"tire_pressure_monitoring_system_tpms_type": "Direct",
"active_safety_system_note": null,
"auto_reverse_system_for_windows_and_sunroofs": "Standard",
"automatic_pedestrian_alerting_sound_for_hybrid_and_ev_only": null,
"event_data_recorder_edr": null,
"keyless_ignition": null,
"sae_automation_level_from": null,
"sae_automation_level_to": null,
"ncsa_body_type": "Station Wagon (excluding van and truck based)",
"ncsa_make": "KIA",
"ncsa_model": "Soul",
"ncsa_note": null,
"adaptive_cruise_control_acc": null,
"crash_imminent_braking_cib": null,
"blind_spot_warning_bsw": null,
"forward_collision_warning_fcw": null,
"lane_departure_warning_ldw": null,
"lane_keeping_assistance_lka": null,
"backup_camera": "Standard",
"parking_assist": null,
"bus_length_feet": null,
"bus_floor_configuration_type": "Not Applicable",
"bus_type": "Not Applicable",
"other_bus_info": null,
"custom_motorcycle_type": "Not Applicable",
"motorcycle_suspension_type": "Not Applicable",
"motorcycle_chassis_type": "Not Applicable",
"other_motorcycle_info": null,
"dynamic_brake_support_dbs": null,
"pedestrian_automatic_emergency_braking_paeb": null,
"automatic_crash_notification_acn_advanced_automatic_crash_notification_aacn": null,
"daytime_running_light_drl": "Standard",
"headlamp_light_source": "Halogen",
"semiautomatic_headlamp_beam_switching": null,
"adaptive_driving_beam_adb": null,
"rear_cross_traffic_alert": null,
"rear_automatic_emergency_braking": null,
"blind_spot_intervention_bsi": null,
"lane_centering_assistance": null
},
"trims": [
{
"id": 2236,
"make_model_id": 56,
"year": 2022,
"name": "LX",
"description": "LX 4dr Wagon (2.0L 4cyl CVT)",
"msrp": 19290,
"invoice": 18614,
"created": "2022-08-31T00:08:47+00:00",
"modified": "2022-08-31T00:08:47+00:00"
},
{
"id": 2237,
"make_model_id": 56,
"year": 2022,
"name": "X-Line",
"description": "X-Line 4dr Wagon (2.0L 4cyl CVT)",
"msrp": 22690,
"invoice": 21895,
"created": "2022-08-31T00:08:47+00:00",
"modified": "2022-08-31T00:08:47+00:00"
},
{
"id": 2238,
"make_model_id": 56,
"year": 2022,
"name": "S",
"description": "S 4dr Wagon (2.0L 4cyl CVT)",
"msrp": 21590,
"invoice": 20835,
"created": "2022-08-31T00:08:47+00:00",
"modified": "2022-08-31T00:08:47+00:00"
},
{
"id": 2239,
"make_model_id": 56,
"year": 2022,
"name": "Turbo",
"description": "Turbo 4dr Wagon (1.6L 4cyl Turbo 7AM)",
"msrp": 27890,
"invoice": 26634,
"created": "2022-08-31T00:08:47+00:00",
"modified": "2022-08-31T00:08:47+00:00"
},
{
"id": 2240,
"make_model_id": 56,
"year": 2022,
"name": "EX",
"description": "EX 4dr Wagon (2.0L 4cyl CVT)",
"msrp": 23590,
"invoice": 22529,
"created": "2022-08-31T00:08:47+00:00",
"modified": "2022-08-31T00:08:47+00:00"
},
{
"id": 2241,
"make_model_id": 56,
"year": 2022,
"name": "GT-Line",
"description": "GT-Line 4dr Wagon (2.0L 4cyl CVT)",
"msrp": 22690,
"invoice": 21668,
"created": "2022-08-31T00:08:47+00:00",
"modified": "2022-08-31T00:08:47+00:00"
}
]
}
CarAPI is developer friendly. Only pay when you're ready to go live. CarAPIs free vehicle data set requires no account.