Appraisal
v0.1.0A trade-in / vehicle appraisal: a graded condition inspection plus one or more valuations, reconditioning estimates, an outstanding payoff, and a firm trade offer for a single vehicle. Modernizes ADF's <price type="appraisal"> and <condition> blocks into typed JSON, and carries the AutomotiveAPI-style value guidebook vocabulary (KBB, Black Book, MMR, Galves, NADA/JD Power). Vehicle attributes are captured inline on the appraisal snapshot so the appraised state is preserved even if the underlying Vehicle record later changes.
Resources
inventory.get_appraisalinventory.appraise_tradeappraisal.example.jsonJSON
{
"id": "7c2f9a44-8e21-4d3b-b6c1-0f9a2e5d1a37",
"source_ids": [
{
"system": "vAuto",
"id": "APP-2210349",
"sequence": 1
},
{
"system": "DealerSocket",
"id": "trade-88213",
"sequence": 2
}
],
"vehicle_id": "b1e6c0d2-3f47-4a90-9c8e-5d21a7f4b013",
"customer_id": "e4d9a1b7-2c60-4f33-9a12-7b8e0c1d2a45",
"deal_id": "9f3b2c1a-5d47-4e80-8a63-1c2d3e4f5061",
"dealer_id": "1a2b3c4d-5e6f-4071-8899-aabbccddeeff",
"appraisal_type": "trade_in",
"method": "physical",
"channel": "showroom",
"location": {
"city": "Fort Worth",
"region": "TX",
"postal_code": "76102",
"country": "US",
"lines": [
"1400 Auto Mall Dr"
]
},
"vehicle": {
"year": 2019,
"make": "Chevrolet",
"model": "Silverado 1500",
"trim": "LT",
"vin": "1GCUYDED5KZ118392",
"style_id": "chromedata:401234",
"body_style": "Crew Cab",
"doors": 4,
"engine": "5.3L V8",
"cylinders": 8,
"odometer": {
"value": 68450,
"units": "mi",
"status": "original"
},
"drivetrain": "4wd",
"transmission": "automatic",
"fuel_type": "gasoline",
"exterior_color": "Summit White",
"interior_color": "Jet Black",
"keys_count": 2,
"title_status": "clean",
"title_in_hand": false,
"prior_use": "personal",
"options": [
{
"name": "Z71 Off-Road Package",
"code": "Z71",
"source": "factory",
"value_adjustment": {
"amount": 650,
"currency": "USD"
}
},
{
"name": "Trailering Package",
"code": "NHT",
"source": "factory",
"value_adjustment": {
"amount": 250,
"currency": "USD"
}
}
]
},
"overall_condition": "good",
"condition_details": [
{
"area": "exterior",
"grade": "good",
"severity": "minor",
"notes": "Minor rock chips on hood; 2-inch dent on rear passenger door.",
"photo_urls": [
"https://cdn.example-dealer.com/appraisals/APP-2210349/ext-rear.jpg"
]
},
{
"area": "interior",
"grade": "good",
"severity": "minor",
"notes": "Light wear on driver seat bolster; no odors."
},
{
"area": "mechanical",
"grade": "excellent",
"severity": "none",
"notes": "No fault codes; recent oil service."
},
{
"area": "tires",
"grade": "fair",
"severity": "moderate",
"notes": "Front tires at 4/32; rears at 7/32."
},
{
"area": "glass",
"grade": "good",
"severity": "minor",
"notes": "Small chip in windshield, lower passenger corner."
},
{
"area": "frame",
"grade": "excellent",
"severity": "none",
"notes": "No measurable structural damage."
}
],
"disclosures": {
"accident_reported": false,
"frame_damage": false,
"flood_damage": false,
"hail_damage": false,
"fire_damage": false,
"airbag_deployed": false,
"smoker": false,
"aftermarket_modifications": false,
"open_recalls": true,
"history_report_source": "Carfax",
"history_report_url": "https://www.carfax.com/report/1GCUYDED5KZ118392"
},
"reconditioning": [
{
"item": "Replace front brake pads and rotors",
"category": "mechanical",
"estimate": {
"amount": 420,
"currency": "USD"
},
"priority": "required",
"status": "identified"
},
{
"item": "Paintless dent repair, rear passenger door",
"category": "body",
"estimate": {
"amount": 275,
"currency": "USD"
},
"priority": "recommended",
"status": "approved"
},
{
"item": "Mount and balance two front tires",
"category": "tires",
"estimate": {
"amount": 360,
"currency": "USD"
},
"priority": "required",
"status": "identified"
},
{
"item": "Full detail and interior shampoo",
"category": "detail",
"estimate": {
"amount": 195,
"currency": "USD"
},
"priority": "recommended",
"status": "identified"
}
],
"reconditioning_total": {
"amount": 1250,
"currency": "USD"
},
"values": [
{
"type": "kbb",
"source": "KBB.com Trade-In",
"condition_tier": "good",
"amount": {
"amount": 27850,
"currency": "USD"
},
"adjusted_amount": {
"amount": 28400,
"currency": "USD"
},
"mileage_used": 68450,
"region": "76102",
"as_of": "2026-06-28"
},
{
"type": "black_book",
"source": "Black Book Wholesale",
"condition_tier": "clean",
"amount": {
"amount": 26400,
"currency": "USD"
},
"mileage_used": 68450,
"region": "TX",
"as_of": "2026-06-28"
},
{
"type": "mmr",
"source": "Manheim Market Report",
"condition_tier": "average",
"amount": {
"amount": 25900,
"currency": "USD"
},
"mileage_used": 68450,
"as_of": "2026-06-27"
},
{
"type": "nada",
"source": "J.D. Power (NADA) Clean Trade",
"condition_tier": "clean",
"amount": {
"amount": 27100,
"currency": "USD"
},
"as_of": "2026-06-28"
},
{
"type": "actual_cash_value",
"source": "Desk ACV",
"amount": {
"amount": 25100,
"currency": "USD"
},
"as_of": "2026-06-30"
},
{
"type": "retail",
"source": "vAuto Live Market Retail",
"amount": {
"amount": 31995,
"currency": "USD"
},
"as_of": "2026-06-30"
}
],
"mileage_adjustment": {
"amount": -350,
"currency": "USD"
},
"options_adjustment": {
"amount": 900,
"currency": "USD"
},
"region_adjustment": {
"amount": 200,
"currency": "USD"
},
"market_days_supply": 41,
"market_rank_percent": 62.5,
"payoff": {
"amount": {
"amount": 18240.55,
"currency": "USD"
},
"type": "loan",
"lender": "GM Financial",
"account_last4": "4417",
"good_through": "2026-07-15",
"per_diem": {
"amount": 3.42,
"currency": "USD"
},
"verified": true,
"verified_at": "2026-06-30T14:10:00Z"
},
"offer": {
"amount": {
"amount": 26000,
"currency": "USD"
},
"type": "trade_allowance",
"guaranteed": false,
"net_equity": {
"amount": 7759.45,
"currency": "USD"
},
"program": "Store Trade Desk",
"expires_at": "2026-07-07T23:59:59Z"
},
"photos": [
{
"url": "https://cdn.example-dealer.com/appraisals/APP-2210349/ext-front.jpg",
"kind": "exterior_front",
"caption": "Front 3/4 driver side",
"taken_at": "2026-06-30T15:40:00Z"
},
{
"url": "https://cdn.example-dealer.com/appraisals/APP-2210349/odo.jpg",
"kind": "odometer",
"taken_at": "2026-06-30T15:40:30Z"
}
],
"notes": "Clean one-owner truck, strong service history. Offer reflects two front tires and PDR on rear door.",
"appraised_by_id": "3a9d5f21-77b4-4c02-8e19-6b0c2d4e8f55",
"appraiser_name": {
"first": "Marcus",
"last": "Reyes",
"full": "Marcus Reyes"
},
"appraised_at": "2026-06-30T15:42:10Z",
"status": "final",
"created_at": "2026-06-30T15:30:00Z",
"updated_at": "2026-06-30T15:45:12Z",
"created_by": "3a9d5f21-77b4-4c02-8e19-6b0c2d4e8f55",
"updated_by": "3a9d5f21-77b4-4c02-8e19-6b0c2d4e8f55",
"extensions": {
"vauto:appraisal_channel": "showroom",
"dealersocket:store_id": "STORE-014"
}
}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.