Skip to content
AutomotiveMCP
SchemasInventory · R01RFC / v0.1

Appraisal

v0.1.0

A 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.

Resourcesinventory.get_appraisalinventory.appraise_trade

appraisal.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.