Year Make Model API
Retrieve comprehensive vehicle information by specifying its year, make, and model. Get detailed specifications, trim levels, and features for vehicles across different regions with our Year Make Model (YMM) API.
Ever needed to look up vehicle details without a VIN? The Year Make Model API allows you to retrieve detailed vehicle information by simply specifying the year of manufacture, make, and model. For more specific results, you can optionally include the trim.
This endpoint allows you to retrieve vehicle information based on its year, make, and model.
Required attributes
- Name
key- Type
- string
- Description
Your CarsXE API key.
- Name
year- Type
- string
- Description
The manufacturing year of the vehicle.
- Name
make- Type
- string
- Description
The manufacturer of the vehicle (e.g., Toyota, Ford, BMW).
- Name
model- Type
- string
- Description
The specific model of the vehicle. (e.g., Camry, F-150, X5)
Optional attributes
- Name
trim- Type
- string
- Description
The vehicle trim. (e.g., XLE, XSE, etc.)
Response attributes
- Name
success- Type
- boolean
- Description
Indicates whether the request was successful.
- Name
input- Type
- object
- Description
The parameters used in the request (key, year, make, model, trim).
- Name
attributes- Type
- object
- Description
Vehicle information container with the following properties:
- Name
name- Type
- string
- Description
Full vehicle name including trim and engine details
- Name
base_msrp- Type
- number
- Description
Base manufacturer's suggested retail price
- Name
base_invoice- Type
- number
- Description
Base dealer invoice price
- Name
total_seating- Type
- number
- Description
Total seating capacity of the vehicle
- Name
color- Type
- object
- Description
Detailed exterior and interior color options with RGB values
- Name
features- Type
- object
- Description
Comprehensive list of standard and optional features categorized by:
- Power Features
- Rear Seats
- Warranty
- Measurements
- Comfort & Convenience
- Drive Train
- Suspension
- Instrumentation
- In Car Entertainment
- Front Seats
- Fuel
- Telematics
- Safety
- Tires and Wheels
- Engine
- Name
optional- Type
- object
- Description
Categorized list of optional features and packages with pricing:
- Safety & Security Options
- Exterior Options
- Interior Options
- Packages
- Additional Fees Options
- Name
is_truck- Type
- boolean
- Description
Indicates if the vehicle is a truck
- Name
is_electric- Type
- boolean
- Description
Indicates if the vehicle is electric
- Name
is_plugin_electric- Type
- boolean
- Description
Indicates if the vehicle is a plug-in hybrid
- Name
timestamp- Type
- string
- Description
ISO timestamp of when the response was generated
- Name
message- Type
- string
- Description
Error message if the request fails. Possible values:
Missing year, make, or modelUser not foundUser not active- Internal server error messages
Frequently asked questions
Request
GET
/v1/ymmcurl -G https://api.carsxe.com/v1/ymm \
-d key=CARSXE_API_KEY \
-d year=2023 \
-d make=Toyota \
-d model=Camry \
-d trim=XLEResponse
{
"success": true,
"input": {
"key": "CARSXE_API_KEY",
"year": "2023",
"make": "Toyota",
"model": "Camry",
"trim": "XLE"
},
"attributes": {
"name": "XLE 4dr Sedan (3.5L 6cyl 8A)",
"base_msrp": 36195,
"base_invoice": 32938,
"total_seating": 5,
"color": {
"exterior": [
{
"name": "Supersonic Red",
"rgb": "226,5,0"
},
{
"name": "Predawn Gray Mica",
"rgb": "99,97,94"
},
{
"name": "Midnight Black Metallic",
"rgb": "0,3,30"
},
{
"name": "Celestial Silver Metallic",
"rgb": "130,131,135"
},
{
"name": "Wind Chill Pearl",
"rgb": "227,233,233"
},
{
"name": "Reservoir Blue",
"rgb": "0,20,70"
}
],
"interior": [
{
"name": "Macadamia, leather",
"rgb": "208,190,166"
},
{
"name": "Ash, leather",
"rgb": "125,124,119"
},
{
"name": "Black, leather",
"rgb": "0,0,0"
}
]
},
"features": {
"standard": {
"Power Feature": [
{
"name": "4 one-touch power windows"
},
{
"name": "1st row power glass extended moonroof"
},
{
"name": "hands-free entry"
},
{
"name": "Heated mirrors"
}
],
"Rearseats": [
{
"name": "Rear head room",
"value": "38.0 in."
},
{
"name": "Rear leg room",
"value": "38.0 in."
},
{
"name": "Rear shoulder room",
"value": "55.7 in."
},
{
"name": "Rear hip room",
"value": "54.7 in."
},
{
"name": "Split-folding rear seatback"
},
{
"name": "folding center armrest"
}
],
"Warranty": [
{
"name": "Basic",
"value": "3 yr./ 36000 mi."
},
{
"name": "Drivetrain",
"value": "5 yr./ 60000 mi."
},
{
"name": "Rust",
"value": "5 yr./ unlimited mi."
},
{
"name": "Roadside assistance",
"value": "2 yr./ unlimited mi."
},
{
"name": "Free maintenance",
"value": "2 yr./ 25000 mi."
}
],
"Measurements": [
{
"name": "Length",
"value": "192.1 in."
},
{
"name": "Overall width without mirrors",
"value": "72.4 in."
},
{
"name": "Height",
"value": "56.9 in."
},
{
"name": "Wheelbase",
"value": "111.2 in."
},
{
"name": "EPA interior volume",
"value": "114.4 cu.ft."
},
{
"name": "Cargo capacity, all seats in place",
"value": "15.1 cu.ft."
},
{
"name": "Turning circle",
"value": "38.0 ft."
},
{
"name": "Ground clearance",
"value": "5.7 in."
},
{
"name": "Curb weight",
"value": "3595 lbs."
},
{
"name": "Country of final assembly",
"value": "United States"
}
],
"Comfort & Convenience": [
{
"name": "keyless ignition"
},
{
"name": "tilt and telescopic steering wheel"
},
{
"name": "Audio and cruise controls on steering wheel"
},
{
"name": "electric power steering"
},
{
"name": "rear view camera"
},
{
"name": "Wireless charging"
},
{
"name": "adaptive cruise control"
},
{
"name": "universal remote transmitter (for garage door, security system, etc.)"
},
{
"name": "front and rear cupholders"
},
{
"name": "front and rear door pockets"
},
{
"name": "overhead console with storage"
},
{
"name": "front seatback storage"
},
{
"name": "leather and simulated alloy steering wheel"
},
{
"name": "Dual zone front climate control"
},
{
"name": "rear ventilation ducts"
},
{
"name": "interior air filtration"
},
{
"name": "Dual illuminating vanity mirrors"
},
{
"name": "electrochromatic inside rearview mirror"
},
{
"name": "turn signal in mirrors"
}
],
"Drive Train": [
{
"name": "Transmission",
"value": "8-speed shiftable automatic"
},
{
"name": "Drive type",
"value": "front wheel drive"
}
],
"Suspension": [
{
"name": "four-wheel independent suspension"
},
{
"name": "Front and rear stabilizer bar"
}
],
"Instrumentation": [
{
"name": "trip computer"
},
{
"name": "external temperature display"
},
{
"name": "tachometer"
},
{
"name": "clock"
}
],
"In Car Entertainment": [
{
"name": "9.0\" infotainment display size"
},
{
"name": "AM/FM stereo"
},
{
"name": "JBL premium brand speakers"
},
{
"name": "800 watts stereo output"
},
{
"name": "9 total speakers"
},
{
"name": "1 subwoofer(s)"
},
{
"name": "Android Auto/Apple CarPlay"
},
{
"name": "USB connection"
},
{
"name": "USB with external media control"
},
{
"name": "satellite radio w/real time traffic satellite radio"
},
{
"name": "3 months of provided satellite radio service"
}
],
"Frontseats": [
{
"name": "Front head room",
"value": "37.5 in."
},
{
"name": "Front leg room",
"value": "42.1 in."
},
{
"name": "Front shoulder room",
"value": "57.7 in."
},
{
"name": "Front hip room",
"value": "55.4 in."
},
{
"name": "leather"
},
{
"name": "bucket front seats"
},
{
"name": "8-way power driver seat"
},
{
"name": "height adjustable driver seat"
},
{
"name": "Driver seat with power adjustable lumbar support"
},
{
"name": "8-way power passenger seat"
},
{
"name": "height adjustable passenger seat"
},
{
"name": "multi-level heated driver seat"
},
{
"name": "multi-level heated passenger seat"
}
],
"Fuel": [
{
"name": "Fuel type",
"value": "regular unleaded"
},
{
"name": "EPA city/highway MPG",
"value": "22/33 MPG"
},
{
"name": "EPA combined MPG",
"value": "26 MPG"
},
{
"name": "Range in miles (city/hwy)",
"value": "347.6/521.4 mi."
},
{
"name": "Fuel tank capacity",
"value": "15.8 gal."
}
],
"Telematics": [
{
"name": "Emergency Service"
},
{
"name": "Airbag Deployment Notification"
},
{
"name": "Stolen Vehicle Tracking/Assistance"
},
{
"name": "Roadside Assistance"
}
],
"Safety": [
{
"name": "blind spot and lane departure warnings accident avoidance system"
},
{
"name": "Lane keep assist"
},
{
"name": "Rear cross traffic alert"
},
{
"name": "pre-collision safety system"
},
{
"name": "post-collision safety system"
},
{
"name": "dual front and dual rear side-mounted airbags"
},
{
"name": "front and rear head airbags"
},
{
"name": "Passenger airbag occupant sensing deactivation"
},
{
"name": "stability control"
},
{
"name": "traction control"
},
{
"name": "child seat anchors"
},
{
"name": "Rear door child safety locks"
},
{
"name": "4-wheel ABS"
},
{
"name": "Ventilated front disc / solid rear disc brakes"
},
{
"name": "Emergency braking assist"
},
{
"name": "tire pressure monitoring"
},
{
"name": "dusk sensing headlamps"
},
{
"name": "auto delay off headlamps"
},
{
"name": "LED headlamp"
},
{
"name": "daytime running lights"
},
{
"name": "Turn signal mirrors"
},
{
"name": "2 front headrests"
},
{
"name": "Front height adjustable headrests"
},
{
"name": "3 rear headrests"
},
{
"name": "Rear height adjustable headrests"
},
{
"name": "Rear center 3-point belt"
},
{
"name": "remote anti-theft alarm system"
},
{
"name": "engine immobilizer"
}
],
"Tires and Wheels": [
{
"name": "alloy wheels"
},
{
"name": "18 x 8.0 in. wheels"
},
{
"name": "All season tires"
},
{
"name": "P235/45R18 tires"
},
{
"name": "temporary spare tire"
},
{
"name": "inside mounted spare tire"
}
],
"Engine": [
{
"name": "Base engine size",
"value": "3.5 L"
},
{
"name": "Cylinders",
"value": "V6"
},
{
"name": "Base engine type",
"value": "gas"
},
{
"name": "Horsepower",
"value": "301 hp @ 6600 rpm"
},
{
"name": "Torque",
"value": "267 lb-ft @ 4700 rpm"
},
{
"name": "Valves",
"value": "24"
},
{
"name": "Cam type",
"value": "Double overhead cam (DOHC)"
},
{
"name": "Valve timing",
"value": "Variable"
},
{
"name": "direct injection"
}
]
},
"optional": {
"Safety & Security Options": [
{
"price": 25,
"name": "First Aid Kit w/PPE"
},
{
"price": 75,
"name": "Emergency Assistance Kit"
}
],
"Exterior Options": [
{
"price": 80,
"name": "Alloy Wheel Locks"
},
{
"price": 129,
"name": "Door Edge Guards"
},
{
"price": 425,
"name": "Special Color"
},
{
"price": 439,
"name": "Paint Protection Film"
},
{
"price": 69,
"name": "Rear Bumper Applique"
},
{
"price": 129,
"name": "Mudguards"
},
{
"price": 199,
"name": "Rear Spoiler"
}
],
"Packages": [
{
"price": 497,
"name": "Protection Package"
},
{
"price": 268,
"name": "Protection Package"
},
{
"price": 373,
"name": "Preferred Accessory Package w/All-Weather Floor Liners"
},
{
"price": 830,
"name": "Driver Assist Package"
},
{
"price": 70,
"name": "Quick Charge Cable Package"
},
{
"price": 1040,
"name": "Navigation Package"
},
{
"price": 373,
"name": "Preferred Accessory Package w/Carpet Mats"
},
{
"price": 370,
"name": "Enhanced Illumination Package 3"
},
{
"price": 299,
"name": "Carpet Mat Package"
},
{
"price": 299,
"name": "All-Weather Floor Liner Package"
},
{
"price": 150,
"name": "Cold Weather Package"
}
],
"Additional Fees Options": [
{
"price": 0,
"name": "50 State Emissions"
}
],
"Interior Options": [
{
"price": 375,
"name": "Integrated Dashcam"
},
{
"price": 345,
"name": "Illuminated Door Sills"
},
{
"price": 129,
"name": "USB Dual Power Port (Rear Only)"
},
{
"price": 25,
"name": "Trunk LED Light Bulb"
},
{
"price": 199,
"name": "Door Sill Protectors"
},
{
"price": 49,
"name": "Hideaway Cargo Net"
},
{
"price": 29,
"name": "Coin Holder/Ashtray Cup"
},
{
"price": 51,
"name": "Cargo Tote"
},
{
"price": 99,
"name": "Universal Tablet Holder"
}
]
}
},
"is_truck": false,
"is_electric": false,
"is_plugin_electric": false,
"timestamp": "2024-11-19T23:48:34.049Z"
}
}