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
Information
Makes
    List all makesgetGet a makegetList models of a makeget
Models
    Get a model with its model yearsgetList trims of a modelget
Trims
    Search and filter trimsgetFull specs of one trimgetExterior and interior colors of a trimgetCompare 2-5 trims side by sideget
Reference
    Health checkgetAvailable filter values with countsgetDataset statisticsget
Schemas
powered by apitogo
CarBase API
CarBase API

Trims

Endpointhttps://sharp-stream-8e0aadb6f.api.apitogo.com

Specific versions of a model in a given year, with prices and full specs


Search and filter trims

GET
https://sharp-stream-8e0aadb6f.api.apitogo.com
/api/trims

Searches all trims. Every filter is optional and filters combine with AND. Exact-match text filters ignore case. Results are paged; trims with no value for the sort field come last.

Search and filter trims › query Parameters

q
​string

Free text, matched against make, model, trim and description

Example: civic sport
make
​string

Make name, exact match, case-insensitive

Example: Toyota
model
​string

Model name, exact match, case-insensitive

Example: RAV4
year
​integer

Model year

year_min
​integer

Earliest model year (inclusive)

year_max
​integer

Latest model year (inclusive)

body_type
​string · enum

Body style, exact match, case-insensitive

Enum values:
Convertible
Coupe
Ext Van
Hatchback
Minivan
SUV
Sedan
Truck (Access Cab)
Example: SUV
engine_type
​string · enum

Power source, exact match, case-insensitive

Enum values:
diesel
electric
electric (fuel cell)
flex-fuel (FFV)
gas
hybrid
mild hybrid
plug-in hybrid
Example: electric
fuel_type
​string

Partial match

drive_type
​string

Partial match, e.g. 'all wheel'

country
​string · enum

Country of origin

Enum values:
Germany
Italy
Japan
South Korea
Sweden
United Kingdom
United States
Vietnam
Example: Japan
min_price
​number

Minimum base MSRP in USD

max_price
​number

Maximum base MSRP in USD

min_hp
​number

Minimum horsepower

max_hp
​number

Maximum horsepower

min_mpg
​number

Minimum EPA combined MPG

min_range
​number

Minimum EV range in miles

min_seats
​integer

Minimum number of seats

sort
​string · enum

price, year, make, model, horsepower, torque, mpg, range, weight, towing, seats. Prefix '-' for descending.

Enum values:
price
-price
year
-year
make
-make
model
-model
Example: -horsepower
page
​integer · min: 1

Page number

Default: 1
limit
​integer · min: 1 · max: 100

Results per page

Default: 20

Search and filter trims › Responses

OK

​object[]
​object
GET/api/trims
curl --request GET \ --url https://sharp-stream-8e0aadb6f.api.apitogo.com/api/trims \ --header 'X-API-Key: YOUR_API_KEY'
shell
Example Responses
{ "data": [ { "id": 401985516, "make": "Hyundai", "model": "Kona Electric", "year": 2024, "trim": "SE", "trim_description": "SE 4dr SUV (electric DD)", "body_type": "SUV", "base_msrp": 32675, "horsepower_hp": 133, "engine_type": "electric", "fuel_type": "electric", "drive_type": "front wheel drive", "transmission": "1-speed direct drive", "total_seating": 5, "epa_combined_mpg": null, "epa_combined_mpge": null, "epa_electricity_range_mi": 197, "image_urls": [ "https://media.ed.edmunds-media.com/hyundai/kona-electric/2024/oem/2024_hyundai_kona-ele...", "https://media.ed.edmunds-media.com/hyundai/kona-electric/2024/oem/2024_hyundai_kona-ele..." ] }, { "id": 401890721, "make": "Mazda", "model": "MX-30", "year": 2022, "trim": "(base)", "trim_description": "4dr SUV (electric DD)", "body_type": "SUV", "base_msrp": 33470, "horsepower_hp": 143, "engine_type": "electric", "fuel_type": "electric", "drive_type": "front wheel drive", "transmission": "1-speed direct drive", "total_seating": 5, "epa_combined_mpg": null, "epa_combined_mpge": 92, "epa_electricity_range_mi": 100, "image_urls": [ "https://media.ed.edmunds-media.com/mazda/mx-30/2022/oem/2022_mazda_mx-30_4dr-suv_base_f...", "https://media.ed.edmunds-media.com/mazda/mx-30/2022/evox/2022_mazda_mx-30_4dr-suv_premi..." ] } ], "pagination": { "page": 1, "limit": 2, "total": 77, "pages": 39 } }
json
application/json

Full specs of one trim

GET
https://sharp-stream-8e0aadb6f.api.apitogo.com
/api/trims/{id}

Returns every spec for one trim, grouped into sections: pricing, body, dimensions, weight and capacity, engine, fuel economy, interior, warranty, origin, review and colors.

Full specs of one trim › path Parameters

id
​integer · required

Trim ID

Example: 401901022

Full specs of one trim › Responses

OK

id
​integer
make
​string
model
​string
year
​integer
trim
​string | null
trim_description
​string | null
make_id
​integer
model_id
​integer
image_urls
​string[]
source_url
​string | null
​object
​object
​object
​object
​object
​object
​object
​object
​object
​object
​object
date_added
​string | null · date
GET/api/trims/{id}
curl --request GET \ --url https://sharp-stream-8e0aadb6f.api.apitogo.com/api/trims/:id \ --header 'X-API-Key: YOUR_API_KEY'
shell
Example Responses
{ "id": 401901022, "make": "Acura", "model": "ILX", "year": 2022, "trim": "(base)", "trim_description": "4dr Sedan w/Premium Package (2.4L 4cyl 8AM)", "make_id": 1, "model_id": 1, "image_urls": [ "https://media.ed.edmunds-media.com/acura/ilx/2019/oem/2019_acura_ilx_sedan_technology-a...", "https://media.ed.edmunds-media.com/acura/ilx/2021/evox/2021_acura_ilx_sedan_base_pr_evo..." ], "source_url": "https://www.edmunds.com/acura/ilx/2022/review/", "pricing": { "base_msrp": 29300, "base_invoice": 28209, "used_price_range": null }, "body": { "body_type": "Sedan", "doors": 4, "total_seating": 5, "car_classification": "Compact car" }, "dimensions": { "length_in": 182.2, "width_in": 70.6, "height_in": 55.6, "wheelbase_in": 105.1, "ground_clearance_in": 5.3, "turning_circle_ft": 36.8, "angle_of_approach_degrees": null, "angle_of_departure_degrees": null, "epa_interior_volume_cu_ft": 101.7, "cargo_capacity_cu_ft": 12.4, "maximum_cargo_capacity_cu_ft": null }, "weight_and_capacity": { "curb_weight_lbs": 3122, "gross_weight_lbs": null, "maximum_payload_lbs": null, "maximum_towing_capacity_lbs": null }, "engine": { "engine_type": "gas", "cylinders": "I4", "engine_size_l": 2.4, "horsepower_hp": 201, "horsepower_rpm": 6800, "torque_ft_lbs": 180, "torque_rpm": 3600, "valves": 16, "valve_timing": "Variable", "cam_type": "Double overhead cam (DOHC)", "drive_type": "front wheel drive", "transmission": "8-speed automated manual" }, "fuel_economy": { "fuel_type": "premium unleaded (recommended)", "fuel_tank_capacity_gal": 13.2, "epa_combined_mpg": 28, "epa_city_highway_mpg": "24/34 MPG", "range_in_miles_city_hwy": "316.8/448.8 mi.", "epa_combined_mpge": null, "epa_city_highway_mpge": null, "epa_electricity_range_mi": null, "epa_kwh_100_mi": null, "epa_time_to_charge_battery_at_240v_hr": null, "battery_capacity_kwh": null }, "interior": { "front_head_room_in": 38, "front_hip_room_in": 50.3, "front_leg_room_in": 42.3, "front_shoulder_room_in": 55.6, "rear_head_room_in": 35.9, "rear_hip_room_in": 51.7, "rear_leg_room_in": 34, "rear_shoulder_room_in": 53.6 }, "warranty": { "basic": "4 yr./ 50000 mi.", "drivetrain": "6 yr./ 70000 mi.", "roadside_assistance": "4 yr./ 50000 mi.", "rust": "5 yr./ unlimited mi." }, "origin": { "country_of_origin": "Japan", "domestic_imported": "Imported", "platform_code_generation_number": "-" }, "review": { "summary": "The 2022 Acura ILX is a small luxury sedan and it's currently the smallest vehicle th...", "pros": [ "Plenty of features for the money", "Good fuel economy for a small sedan" ], "cons": [ "Plasticky interior trim", "Overly stiff ride" ], "whats_new": [ "No significant changes for 2022", "Part of the first ILX generation introduced for 2013" ], "expert_rating": { "overall": "6.6/10", "performance": "6.0/10", "comfort": "6.5/10", "interior": "6.5/10", "technology": "6.0/10", "storage": "6.5/10", "fuel_economy": "8.5/10", "value": "8.0/10", "wildcard": "6.5/10" } }, "colors": { "exterior": [ { "name": "Lunar Silver Metallic", "rgb": [ 141, 145 ], "hex": "#8d919a" }, { "name": "Majestic Black Pearl", "rgb": [ 30, 30 ], "hex": "#1e1e1e" } ], "interior": [ { "name": "Ebony, leather", "rgb": [ 25, 25 ], "hex": "#191919" }, { "name": "Espresso, leather", "rgb": [ 155, 107 ], "hex": "#9b6b57" } ] }, "date_added": "2021-08-08" }
json
application/json

Exterior and interior colors of a trim

GET
https://sharp-stream-8e0aadb6f.api.apitogo.com
/api/trims/{id}/colors

Returns exterior and interior color options with approximate RGB and hex values for swatches.

Exterior and interior colors of a trim › path Parameters

id
​integer · required

Trim ID

Example: 401901022

Exterior and interior colors of a trim › Responses

OK

​object[]
​object[]
GET/api/trims/{id}/colors
curl --request GET \ --url https://sharp-stream-8e0aadb6f.api.apitogo.com/api/trims/:id/colors \ --header 'X-API-Key: YOUR_API_KEY'
shell
Example Responses
{ "exterior": [ { "name": "Lunar Silver Metallic", "rgb": [ 141, 145 ], "hex": "#8d919a" }, { "name": "Majestic Black Pearl", "rgb": [ 30, 30 ], "hex": "#1e1e1e" } ], "interior": [ { "name": "Ebony, leather", "rgb": [ 25, 25 ], "hex": "#191919" }, { "name": "Espresso, leather", "rgb": [ 155, 107 ], "hex": "#9b6b57" } ] }
json
application/json

Compare 2-5 trims side by side

GET
https://sharp-stream-8e0aadb6f.api.apitogo.com
/api/compare

Returns full specs for 2 to 5 trims in the order given, without review and colors.

Compare 2-5 trims side by side › query Parameters

ids
​string · required

Comma-separated trim ids

Example: 401901022,401901023

Compare 2-5 trims side by side › Responses

OK

​object[]

Trim details without review and colors

GET/api/compare
curl --request GET \ --url 'https://sharp-stream-8e0aadb6f.api.apitogo.com/api/compare?ids=%3Cstring%3E' \ --header 'X-API-Key: YOUR_API_KEY'
shell
Example Responses
{ "data": [ { "id": 401901022, "make": "Acura", "model": "ILX", "year": 2022, "trim": "(base)", "trim_description": "4dr Sedan w/Premium Package (2.4L 4cyl 8AM)", "make_id": 1, "model_id": 1, "image_urls": [ "https://media.ed.edmunds-media.com/acura/ilx/2019/oem/2019_acura_ilx_sedan_technology-a...", "https://media.ed.edmunds-media.com/acura/ilx/2021/evox/2021_acura_ilx_sedan_base_pr_evo..." ], "source_url": "https://www.edmunds.com/acura/ilx/2022/review/", "pricing": { "base_msrp": 29300, "base_invoice": 28209, "used_price_range": null }, "body": { "body_type": "Sedan", "doors": 4, "total_seating": 5, "car_classification": "Compact car" }, "dimensions": { "length_in": 182.2, "width_in": 70.6, "height_in": 55.6, "wheelbase_in": 105.1, "ground_clearance_in": 5.3, "turning_circle_ft": 36.8, "angle_of_approach_degrees": null, "angle_of_departure_degrees": null, "epa_interior_volume_cu_ft": 101.7, "cargo_capacity_cu_ft": 12.4, "maximum_cargo_capacity_cu_ft": null }, "weight_and_capacity": { "curb_weight_lbs": 3122, "gross_weight_lbs": null, "maximum_payload_lbs": null, "maximum_towing_capacity_lbs": null }, "engine": { "engine_type": "gas", "cylinders": "I4", "engine_size_l": 2.4, "horsepower_hp": 201, "horsepower_rpm": 6800, "torque_ft_lbs": 180, "torque_rpm": 3600, "valves": 16, "valve_timing": "Variable", "cam_type": "Double overhead cam (DOHC)", "drive_type": "front wheel drive", "transmission": "8-speed automated manual" }, "fuel_economy": { "fuel_type": "premium unleaded (recommended)", "fuel_tank_capacity_gal": 13.2, "epa_combined_mpg": 28, "epa_city_highway_mpg": "24/34 MPG", "range_in_miles_city_hwy": "316.8/448.8 mi.", "epa_combined_mpge": null, "epa_city_highway_mpge": null, "epa_electricity_range_mi": null, "epa_kwh_100_mi": null, "epa_time_to_charge_battery_at_240v_hr": null, "battery_capacity_kwh": null }, "interior": { "front_head_room_in": 38, "front_hip_room_in": 50.3, "front_leg_room_in": 42.3, "front_shoulder_room_in": 55.6, "rear_head_room_in": 35.9, "rear_hip_room_in": 51.7, "rear_leg_room_in": 34, "rear_shoulder_room_in": 53.6 }, "warranty": { "basic": "4 yr./ 50000 mi.", "drivetrain": "6 yr./ 70000 mi.", "roadside_assistance": "4 yr./ 50000 mi.", "rust": "5 yr./ unlimited mi." }, "origin": { "country_of_origin": "Japan", "domestic_imported": "Imported", "platform_code_generation_number": "-" }, "date_added": "2021-08-08" }, { "id": 402002843, "make": "Honda", "model": "Civic", "year": 2024, "trim": "Sport", "trim_description": "Sport 4dr Sedan (2.0L 4cyl CVT)", "make_id": 17, "model_id": 181, "image_urls": [ "https://media.ed.edmunds-media.com/honda/civic/2023/oem/2023_honda_civic_sedan_si_fq_oe...", "https://media.ed.edmunds-media.com/honda/civic/2023/oem/2023_honda_civic_sedan_si_fq_oe..." ], "source_url": "https://www.edmunds.com/honda/civic/2024/review/", "pricing": { "base_msrp": 25550, "base_invoice": null, "used_price_range": null }, "body": { "body_type": "Sedan", "doors": 4, "total_seating": 5, "car_classification": "Compact car" }, "dimensions": { "length_in": 184, "width_in": 70.9, "height_in": 55.7, "wheelbase_in": 107.7, "ground_clearance_in": null, "turning_circle_ft": 38.1, "angle_of_approach_degrees": null, "angle_of_departure_degrees": null, "epa_interior_volume_cu_ft": 113.8, "cargo_capacity_cu_ft": 14.8, "maximum_cargo_capacity_cu_ft": null }, "weight_and_capacity": { "curb_weight_lbs": 2935, "gross_weight_lbs": null, "maximum_payload_lbs": null, "maximum_towing_capacity_lbs": null }, "engine": { "engine_type": "gas", "cylinders": "I4", "engine_size_l": 2, "horsepower_hp": 158, "horsepower_rpm": 6500, "torque_ft_lbs": 138, "torque_rpm": 4200, "valves": 16, "valve_timing": "Variable", "cam_type": "Double overhead cam (DOHC)", "drive_type": "front wheel drive", "transmission": "continuously variable-speed automatic" }, "fuel_economy": { "fuel_type": "regular unleaded", "fuel_tank_capacity_gal": 12.4, "epa_combined_mpg": 33, "epa_city_highway_mpg": "30/37 MPG", "range_in_miles_city_hwy": "372.0/458.8 mi.", "epa_combined_mpge": null, "epa_city_highway_mpge": null, "epa_electricity_range_mi": null, "epa_kwh_100_mi": null, "epa_time_to_charge_battery_at_240v_hr": null, "battery_capacity_kwh": null }, "interior": { "front_head_room_in": 39.3, "front_hip_room_in": 54.3, "front_leg_room_in": 42.3, "front_shoulder_room_in": 57, "rear_head_room_in": 37.1, "rear_hip_room_in": 48.9, "rear_leg_room_in": 37.4, "rear_shoulder_room_in": 56 }, "warranty": { "basic": "3 yr./ 36000 mi.", "drivetrain": "5 yr./ 60000 mi.", "roadside_assistance": "3 yr./ 36000 mi.", "rust": "5 yr./ unlimited mi." }, "origin": { "country_of_origin": "Japan", "domestic_imported": "Imported", "platform_code_generation_number": "10th gen" }, "date_added": "2023-08-20" } ] }
json
application/json

ModelsReference