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

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

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.