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.

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

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

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.

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

Start developing today, no fees, no signup

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