TrueCar Listing Detail API returns one public TrueCar vehicle listing by VIN: year, make, model, trim, mileage, engine, transmission, colors, fuel economy, seller notes as plain text, pricing (list price, dealer asking price, MSRP for new cars, price quality rating, dealer fees and estimated monthly payment), vehicle history (accidents, owners, title flags, report date), warranties, feature highlights, technical specs, images and the dealer with address, phone and opening hours. A VIN that is sold, unlisted or unknown returns a non-billable 404.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
string
Required
17-character vehicle identification number (no I, O or Q), e.g. 19UDE2F36KA009123. Works for used and new cars. Example: 19UDE2F36KA009123.
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"mpg": {
"city": 24,
"highway": 34,
"combined": 28
},
"url": "https://www.truecar.com/used-cars-for-sale/listing/19UDE2F36KA009123/",
"vin": "19UDE2F36KA009123",
"make": "Acura",
"trim": "Base",
"year": 2019,
"model": "ILX",
"specs": [
{
"name": "Mechanical",
"items": [
{
"name": "Front Brake Diameter",
"unit": "in",
"value": 12.3
},
{
"name": "Rear Brake Diameter",
"unit": "in",
"value": 11.1
},
{
"name": "First Gear Ratio",
"value": 3.08
}
]
}
],
"dealer": {
"id": 7724,
"city": "Houston",
"name": "Group 1 Acura Southwest Houston",
"phone": "(713) 596-2300",
"state": "TX",
"address": "10505 Southwest Fwy",
"postal_code": "77074",
"inventory_url": "https://www.group1acurasouthwesthouston.com/inventory/used-2019-acura-ilx-fwd-4dr-car-19ude2f36ka009123/",
"opening_hours": {
"friday": "9:00am-8:00pm",
"monday": "9:00am-8:00pm",
"sunday": "Closed",
"tuesday": "9:00am-8:00pm",
"saturday": "9:00am-7:00pm",
"thursday": "9:00am-8:00pm",
"wednesday": "9:00am-8:00pm"
}
},
"engine": "2.4L Inline-4 Gas",
"images": [
"https://listings-prod.tcimg.net/listings/7724/23/91/19UDE2F36KA009123/001_2026091106.jpg",
"https://listings-prod.tcimg.net/listings/7724/23/91/19UDE2F36KA009123/002_2026091106.jpg",
"https://listings-prod.tcimg.net/listings/7724/23/91/19UDE2F36KA009123/003_2026091106.jpg"
],
"history": {
"is_lemon": false,
"is_salvage": false,
"owner_count": 1,
"report_date": "2026-09-08T14:44:31Z",
"is_fleet_car": false,
"is_rental_car": false,
"accident_count": 0,
"is_theft_recovered": false
},
"mileage": 78515,
"pricing": {
"currency": "USD",
"list_price": 17815,
"dealer_fees": [
{
"label": "Doc",
"amount": 225
}
],
"price_quality": "high",
"dealer_asking_price": 17590,
"estimated_monthly_payment": {
"amount": 255.61,
"months": 72,
"apr_percent": 6.77,
"due_at_signing": 2500
}
},
"condition": "used",
"fuel_type": "Gas",
"image_url": "https://listings-prod.tcimg.net/listings/7724/23/91/19UDE2F36KA009123/001_2026091106.jpg",
"listed_at": "2026-09-08T18:45:00Z",
"make_slug": "acura",
"body_style": "Sedan",
"drive_type": "Front Wheel Drive",
"highlights": {
"safety": [
"Speed Adaptive Steering",
"Hill Start Assist Control (HAC)",
"Active Lane Keep Assist"
],
"comfort": [
"Driver Lumbar Support",
"Dual-Zone Climate Control",
"Front Heated Seats"
],
"appearance": [
"Moonroof",
"Premium Synthetic Seats",
"Leather Steering Wheel"
],
"technology": [
"Bluetooth Hands-Free / Streaming Audio",
"5.0\" Screen",
"Keyless Ignition"
]
},
"model_slug": "ilx",
"warranties": [
{
"name": "Basic",
"miles": 50000,
"years": 4
},
{
"name": "Drivetrain",
"miles": 70000,
"years": 6
},
{
"name": "Rust",
"years": 5
},
{
"name": "Roadside",
"miles": 50000,
"years": 4
}
],
"image_count": 33,
"key_features": [
"Premium Wheels",
"Moonroof",
"Premium Seat Material",
"Front Heated Seats"
],
"seller_notes": "EPA estimate 34 MPG Hwy/24 MPG City! Excellent Condition. Platinum White Pearl exterior and Ebony interior, ILX trim. Moonroof, Heated Seats, CD Player, Bluetooth\u00ae, Back-Up Camera, Aluminum Wheels, iPod/MP3 Input, Non-Smoker vehicle, Manager Special\n\nKEY FEAT\u2026",
"stock_number": "KA009123",
"transmission": "Automatic",
"exterior_color": "Platinum White Pearl",
"interior_color": "Ebony"
},
"meta": {
"billable": true,
"endpoint_family": "listing"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
The vin parameter is missing or is not a 17-character VIN. This response is not billable.
{
"errors": {
"vin": [
"A VIN is required, e.g. 19UDE2F36KA009123."
]
},
"message": "The request validation failed"
}Listing Not Found
No active TrueCar listing exists for the VIN (sold, delisted or never listed). This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "listing"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested TrueCar listing was not found."
},
"success": false
}Upstream Unavailable
TrueCar is temporarily unreachable, blocked the request or answered a page without the expected data (PARSER_DRIFT). Retry later; this response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "listing"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "TrueCar is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.