CarBaseCarBaseCarBase
CarBase

Specs, prices and colors of every new US-market car, 2022 to 2025.

Developers

  • Getting started
  • API Reference
  • Pricing
  • Sign in

© 2026 CarBase

  • Documentation
  • API Reference
  • Pricing
CarBase APIGetting startedCompareConventionsData dictionaryErrorsMakesModelsReference dataTrims
powered by apitogo
Documentation

Data dictionary

Every field returned by Get a trim, by section. Any field can be null when the value is unknown.

Top level

FieldTypeDescription
idintegerTrim ID
makestringMake name
modelstringModel name
yearintegerModel year
trimstringTrim name, (base) for the base trim
trim_descriptionstringBody, engine and transmission, for example 4dr Sedan (2.0L 4cyl CVT)
make_idintegerMake ID
model_idintegerModel ID
image_urlsstring[]Photo URLs
source_urlstringSource review page
date_addeddateDate the trim was added to the dataset, YYYY-MM-DD

pricing

FieldTypeDescription
base_msrpintegerManufacturer's suggested retail price, USD
base_invoiceintegerDealer invoice price, USD
used_price_rangestringUsed price range, where known

body

FieldTypeDescription
body_typestringBody style, see values below
doorsintegerNumber of doors
total_seatingintegerNumber of seats
car_classificationstringSize class, see values below

dimensions

FieldTypeDescription
length_innumberLength, inches
width_innumberWidth, inches
height_innumberHeight, inches
wheelbase_innumberWheelbase, inches
ground_clearance_innumberGround clearance, inches
turning_circle_ftnumberTurning circle, feet
angle_of_approach_degreesnumberOff-road approach angle
angle_of_departure_degreesnumberOff-road departure angle
epa_interior_volume_cu_ftnumberPassenger volume, cubic feet
cargo_capacity_cu_ftnumberCargo space behind rear seats, cubic feet
maximum_cargo_capacity_cu_ftnumberCargo space with rear seats folded, cubic feet

weight_and_capacity

FieldTypeDescription
curb_weight_lbsnumberEmpty weight, pounds
gross_weight_lbsnumberMaximum loaded weight, pounds
maximum_payload_lbsnumberMaximum payload, pounds
maximum_towing_capacity_lbsnumberMaximum towing, pounds

engine

FieldTypeDescription
engine_typestringPower source, see values below
cylindersstringLayout and count, for example I4, V6. null for EVs
engine_size_lnumberDisplacement, litres
horsepower_hpintegerPeak horsepower
horsepower_rpmintegerRPM at peak horsepower
torque_ft_lbsintegerPeak torque, pound-feet
torque_rpmintegerRPM at peak torque
valvesintegerNumber of valves
valve_timingstringFor example Variable
cam_typestringFor example Double overhead cam (DOHC)
drive_typestringSee values below
transmissionstringFor example 8-speed shiftable automatic

fuel_economy

FieldTypeDescription
fuel_typestringFor example regular unleaded, premium unleaded (required), electric
fuel_tank_capacity_galnumberTank size, US gallons
epa_combined_mpgintegerEPA combined miles per gallon
epa_city_highway_mpgstringEPA city and highway MPG, for example 24/34 MPG
range_in_miles_city_hwystringRange on a full tank, city and highway
epa_combined_mpgeintegerEPA combined miles per gallon equivalent, for EVs and plug-ins
epa_city_highway_mpgestringEPA city and highway MPGe
epa_electricity_range_miintegerElectric range, miles
epa_kwh_100_minumberEnergy use, kWh per 100 miles
epa_time_to_charge_battery_at_240v_hrnumberCharge time at 240V, hours
battery_capacity_kwhnumberBattery size, kWh

interior

All values are in inches.

FieldDescription
front_head_room_inFront head room
front_hip_room_inFront hip room
front_leg_room_inFront leg room
front_shoulder_room_inFront shoulder room
rear_head_room_inRear head room
rear_hip_room_inRear hip room
rear_leg_room_inRear leg room
rear_shoulder_room_inRear shoulder room

warranty

Each value is text in the form 4 yr./ 50000 mi..

FieldDescription
basicBasic (bumper-to-bumper) warranty
drivetrainPowertrain warranty
roadside_assistanceRoadside assistance
rustCorrosion warranty

origin

FieldTypeDescription
country_of_originstringCountry of the make, see values below
domestic_importedstringDomestic or Imported
platform_code_generation_numberstringPlatform or generation code, - if unknown

review

FieldTypeDescription
summarystringReview text
prosstring[]Strengths
consstring[]Weaknesses
whats_newstring[]Changes for this model year
expert_ratingobjectScores as text such as 6.5/10: overall, performance, comfort, interior, technology, storage, fuel_economy, value, wildcard

colors

See Get trim colors.

Allowed values

body_type

Convertible, Coupe, Ext Van, Hatchback, Minivan, SUV, Sedan, Van, Wagon, and trucks by cab style: Truck (Access 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)

engine_type

gas, diesel, electric, electric (fuel cell), hybrid, mild hybrid, plug-in hybrid, flex-fuel (FFV)

drive_type

front wheel drive, rear wheel drive, all wheel drive, four wheel drive

country_of_origin

Germany, Italy, Japan, South Korea, Sweden, United Kingdom, United States, Vietnam

car_classification

Subcompact car, Compact car, Mid-size car, Full-size car, Sports compact car, Sports car, Roadster car, Grand tourer, Supercar, Small SUV, Compact SUV, Mid-size SUV, Full-size SUV, SUV, Subcompact crossover SUV, Compact crossover SUV, Mid-size crossover SUV, Full-size crossover SUV, Off-road vehicle, Minivan, Full-size van, Compact pickup truck, Mid-size pickup truck, Full-size pickup truck

GET /api/filters always returns the current values.

Data source

Teoalida Year-Make-Model-Trim car database, US market, new cars only, updated February 2024.

Last modified on November 7, 2026
ConventionsErrors
On this page
  • Top level
  • pricing
  • body
  • dimensions
  • weight_and_capacity
  • engine
  • fuel_economy
  • interior
  • warranty
  • origin
  • review
  • colors
  • Allowed values
    • body_type
    • engine_type
    • drive_type
    • country_of_origin
    • car_classification
  • Data source