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 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
}
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 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"
}
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 |
|
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 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 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.
The developer friendly Vehicle API
Copyright © 2023 CarAPI all rights reserved.