--- title: "Get vehicle data." method: GET path: "/api/trims/v2/{id}" tags: ["Trims"] --- # Get vehicle data. `GET /api/trims/v2/{id}` The demo dataset contains trims sold between years 2015 - 2020. To access years 1900 - today please purchase a [Premium Subscription](/pricing). You must include a valid JWT in the header once you have purchased a subscription otherwise you will continue to receive the demo dataset. Returns all data associated with the vehicle trim. ## Path parameters - `id` string, required ## Response `200` - object - `id` integer - `make_id` integer - `model_id` integer - `submodel_id` integer - `year` integer - `make` string - `model` string - `series` string - `submodel` string - `trim` string - `description` string - `msrp` integer - `invoice` integer - `created` string, datetime - `modified` string, datetime - `bodies` MakeModelTrimBody[] - `id` integer - `make_model_trim_id` integer - `type` '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)' | 'Unknown' | 'Van' | 'Wagon' — The body type, such as SUV or Sedan - `doors` integer — Number of doors — generally including a hatchback as an additional door - `length` number, float — Total length (in inches) of the vehicle in inches - `width` number, float — Total width (in inches) of the vehicle - `seats` integer — Number of passenger seats in the vehicle. - `height` number, float — Total height (in inches) of the vehicle - `wheel_base` number, float — The horizontal distance (in inches) between the centers of the front and rear wheels - `front_track` number, float — The distance (in inches) between the centerline of the wheels - `rear_track` number, float — The distance (in inches) between the hub flanges on an axle - `ground_clearance` number, float — The distance (in inches) between the lowest point on the undersurface of the vehicle and the road - `cargo_capacity` number, float — The standard total cubic feet of space in a vehicles cargo area - `max_cargo_capacity` number, float — The maximum total cubic feet of space in a vehicles cargo area - `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 - `gross_weight` integer — Gross weight (in pounds) considers all components—including passengers, cargo, and both the tow vehicle weight—if one is attached - `max_payload` integer — Maximum weight in pounds that a vehicle can safely carry - `max_towing_capacity` integer — Maximum weight in pounds that a vehicle can safely tow - `engines` MakeModelTrimEngine[] - `id` integer - `make_model_trim_id` integer - `engine_type` 'diesel' | 'electric' | 'electric (fuel cell)' | 'flex-fuel (FFV)' | 'gas' | 'hybrid' | 'mild hybrid' | 'natural gas (CNG)' | 'plug-in hybrid' — Type of engine - `fuel_type` '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' | 'midgrade unleaded (recommended)' | 'natural gas' | 'premium unleaded (recommended)' | 'premium unleaded (required)' | 'regular unleaded' — The fuel the vehicle uses - `cylinders` 'flat 4' | 'flat 6' | 'I2' | 'I3' | 'I4' | 'I5' | 'I6' | 'rotary 0' | 'V10' | 'V12' | 'V6' | 'V8' | 'W12' | 'W16' | 'W8' — How many cylinders the engine has - `size` number, float — Total size of the engine in liters - `horsepower_hp` integer — One horsepower equals 33,000 foot-pounds of work per minute - `horsepower_rpm` integer - `torque_ft_lbs` integer — The torque (turning force) of the vehicle's engine. - `torque_rpm` integer - `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. - `valve_timing` 'Variable' — In a piston engine, the valve timing is the precise timing of the opening and closing of the valves. - `cam_type` 'Double overhead cam (DOHC)' | 'Overhead valves (OHV)' | 'Single overhead cam (SOHC)' — Camshafts are integral components of internal combustion engines, responsible for controlling the opening and closing of the engine's intake and exhaust valves. - `drive_type` 'all wheel drive' | 'four wheel drive' | 'front wheel drive' | 'rear wheel drive' — The drive type which delivers power to the wheels. - `transmission` '1-speed automatic' | '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 manual, 8-speed automatic' | '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' — Type of transmission - `mileages` MakeModelTrimMileage[] - `id` integer - `make_model_trim_id` integer - `fuel_tank_capacity` number, float — How much fuel the vehicle holds (gallons) - `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%. - `epa_city_mpg` integer — Miles per gallon for city driving - `epa_highway_mpg` integer — Miles per gallon for highway driving - `range_city` integer — Total range in miles on a full tank for city driving - `range_highway` integer — Total range in miles on a full tank for highway driving - `battery_capacity_electric` integer — Total capacity of the battery kWh - `epa_time_to_charge_hr_240v_electric` number, float — How long it takes to charge an EV battery - `epa_kwh_100_mi_electric` integer — kWh used to drive 100 miles for an electric vehicle - `range_electric` integer — Range for electric vehicles in miles - `epa_highway_mpg_electric` integer — MPG equivalent for driving electric vehicles on the highway - `epa_city_mpg_electric` integer — MPG equivalent for driving electric vehicles in the city - `epa_combined_mpg_electric` integer — MPG equivalent for electric vehicles - `exterior_colors` MakeModelTrimExteriorColor[] - `id` integer - `make_model_trim_id` integer - `name` string — Color and shade - `rgb` string — Red, Green, Blue (RGB) value - `interior_colors` MakeModelTrimInteriorColor[] - `id` integer - `make_model_trim_id` integer - `name` string — Color and shade - `rgb` string — Red, Green, Blue (RGB) value ## Other responses - `400` — BadRequestException - `404` — RecordNotFoundException - `405` — MethodNotAllowedException - `429` — TooManyRequestsException - Max Per Minute: 600 - `503` — ServiceUnavailableException --- [API](https://skmtc.net/carapi/apis/car-api-documentation.md) · [All operations](https://skmtc.net/carapi/apis/car-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carapi/car-api-documentation/revisions/5331e15a22af/schema)