Vehicle
v0.1.0A single inventory unit at a dealership: a new, used, or manufacturer-certified vehicle with full identity, classification, mechanical spec, condition/history, warranty, pricing, availability, and media. Field lineage draws on the ADF/ADX (Auto-lead Data Format) vehicle block, the Monroney label (window sticker) standard, the NHTSA vPIC VIN-decode catalog, the federal Truth-in-Mileage Act odometer disclosure, and the OpenTrack/AutomotiveAPI inventory feed conventions where noted. Consumed by AI agents via inventory.get_vehicle and inventory.search_vehicles.
Resources
inventory.get_vehicleinventory.search_vehiclesvehicle.example.jsonJSON
{
"id": "b3f1c2a4-5d6e-4f7a-8b9c-0d1e2f3a4b5c",
"source_ids": [
{
"system": "dms",
"id": "STK-48213"
},
{
"system": "inventory_feed",
"id": "hg-2024-camry-48213",
"sequence": 1
}
],
"vin": "4T1BZ1HK3PU123456",
"stock_number": "T48213",
"condition": "certified",
"condition_grade": "extra_clean",
"year": 2023,
"make": "Toyota",
"model": "Camry",
"trim": "XSE V6",
"series": "2560",
"body_style": "sedan",
"doors": 4,
"seating_capacity": 5,
"drivetrain": "fwd",
"transmission": {
"type": "automatic",
"speeds": 8,
"description": "8-Speed Automatic with paddle shifters"
},
"fuel_type": "gasoline",
"engine": {
"type": "v",
"description": "3.5L V6 24-Valve DOHC",
"displacement_l": 3.5,
"cylinders": 6,
"horsepower": 301,
"torque_lb_ft": 267,
"induction": "naturally_aspirated"
},
"fuel_economy": {
"city_mpg": 22,
"highway_mpg": 33,
"combined_mpg": 26,
"co2_g_per_mi": 341
},
"colors": {
"exterior": {
"name": "Celestial Silver Metallic",
"code": "1J9",
"generic": "silver"
},
"interior": {
"name": "Black SofTex",
"code": "20",
"generic": "black"
}
},
"dimensions": {
"length_in": 192.1,
"width_in": 72.4,
"height_in": 56.9,
"wheelbase_in": 111.2,
"ground_clearance_in": 5.7,
"curb_weight_lb": 3572,
"cargo_volume_cu_ft": 15.1,
"fuel_tank_gal": 15.8
},
"odometer": {
"value": 18452,
"units": "mi",
"status": "original"
},
"title": {
"status": "clear",
"brand": "clean",
"state": "US-TX"
},
"prior_use": [
"lease"
],
"history": {
"owners_count": 1,
"accidents_count": 0,
"is_one_owner": true,
"has_open_recall": false,
"has_frame_damage": false,
"has_airbag_deployment": false,
"title_brand_reported": false,
"last_reported_odometer": 18201,
"service_records_count": 6,
"carfax_url": "https://www.carfax.com/vhr/4T1BZ1HK3PU123456",
"autocheck_url": "https://www.autocheck.com/vehiclehistory/4T1BZ1HK3PU123456"
},
"recalls": [],
"warranty": {
"basic_months": 36,
"basic_miles": 36000,
"powertrain_months": 60,
"powertrain_miles": 60000,
"corrosion_months": 60,
"roadside_months": 24,
"is_factory_remaining": true
},
"cpo": {
"is_certified": true,
"program": "Toyota Certified Used Vehicles",
"certified_date": "2026-05-14",
"warranty_months": 12,
"warranty_miles": 12000,
"inspection_point_count": 160
},
"packages": [
{
"code": "CF",
"name": "Cold Weather Package",
"price": {
"amount": 650,
"currency": "USD"
}
}
],
"features": [
{
"name": "Adaptive Cruise Control",
"category": "driver_assistance",
"code": "DRCC",
"is_factory": true
},
{
"name": "Heated Front Seats",
"category": "comfort_convenience",
"is_factory": true
},
{
"name": "JBL Premium Audio",
"category": "entertainment",
"is_factory": true
},
{
"name": "Blind Spot Monitor",
"category": "safety",
"is_factory": true
},
{
"name": "Panoramic Glass Roof",
"category": "exterior",
"is_factory": true
},
{
"name": "All-Weather Floor Liners",
"category": "interior",
"is_factory": false
}
],
"pricing": {
"currency": "USD",
"prices": [
{
"type": "msrp",
"amount": {
"amount": 39985,
"currency": "USD"
}
},
{
"type": "selling",
"amount": {
"amount": 31998,
"currency": "USD"
}
},
{
"type": "internet",
"amount": {
"amount": 30998,
"currency": "USD"
},
"label": "Internet Special"
}
],
"rebates": [
{
"name": "CPO Bonus Cash",
"amount": {
"amount": 1000,
"currency": "USD"
},
"expires": "2026-07-31",
"conditional": false
}
],
"dealer_fees": [
{
"name": "Documentation Fee",
"amount": {
"amount": 150,
"currency": "USD"
},
"taxable": true
},
{
"name": "Title & Registration",
"amount": {
"amount": 95,
"currency": "USD"
},
"taxable": false
}
],
"price_disclaimer": "Price excludes tax, title, license and $150 documentary fee. Internet price requires financing through Toyota Financial Services with approved credit."
},
"incentives": [
{
"type": "apr",
"name": "TFS Certified APR",
"apr_percentage": 3.99,
"term_months": 60,
"expires": "2026-07-31"
}
],
"availability": {
"status": "available",
"lot_location": "Front Row A",
"is_in_service_loaner_fleet": false,
"dealer_id": "9a8b7c6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d"
},
"days_in_stock": 27,
"acquisition": {
"source": "lease_return",
"acquired_date": "2026-06-01",
"acquisition_cost": {
"amount": 27400,
"currency": "USD"
},
"reconditioning_cost": {
"amount": 1150,
"currency": "USD"
}
},
"media": [
{
"type": "image",
"url": "https://cdn.example-dealer.com/veh/48213/hero.jpg",
"caption": "3/4 front",
"sequence": 0,
"is_primary": true,
"width_px": 1920,
"height_px": 1080
},
{
"type": "image",
"url": "https://cdn.example-dealer.com/veh/48213/rear.jpg",
"caption": "Rear",
"sequence": 1,
"is_primary": false
},
{
"type": "360",
"url": "https://cdn.example-dealer.com/veh/48213/spin",
"caption": "360 spin",
"sequence": 2,
"is_primary": false
},
{
"type": "video",
"url": "https://cdn.example-dealer.com/veh/48213/walkaround.mp4",
"caption": "Walkaround",
"sequence": 3,
"is_primary": false
}
],
"window_sticker_url": "https://cdn.example-dealer.com/veh/48213/monroney.pdf",
"listed_at": "2026-06-03T14:22:00Z",
"created_at": "2026-06-03T14:20:11Z",
"updated_at": "2026-06-29T09:05:44Z",
"created_by": "11111111-2222-3333-4444-555555555555",
"updated_by": "11111111-2222-3333-4444-555555555555",
"extensions": {
"vendor.homenet_id": "HN-9928173",
"vendor.merchandising_score": 92
}
}Object shapes align with the AutomotiveAPI open data standard where sensible, and with the industry's ADF lead format — so a conformant server maps cleanly onto systems dealers already run.