{"openapi":"3.1.0","info":{"title":"DealerDirect National Car Inventory & Buyer Shield API","version":"2.139.0","description":"Public REST & Streamable HTTP MCP API for searching 1,035,000+ New, Used, CPO, and Classic/Collector vehicles across 3,486 US dealerships and running self-serve Buyer Shield Out-The-Door (OTD) price inquiries."},"servers":[{"url":"https://dealerdirect.herrington.ai","description":"Production Server"}],"paths":{"/api/v1/vehicles":{"get":{"operationId":"searchInventory","summary":"Search New, Used, CPO & Classic/Collector vehicle inventory","parameters":[{"name":"query","in":"query","schema":{"type":"string"},"description":"Free-text search (e.g. 'Porsche 911', '1969 Camaro', 'hybrid SUV')"},{"name":"condition","in":"query","schema":{"type":"string","enum":["new","used","certified"]}},{"name":"make","in":"query","schema":{"type":"string"}},{"name":"model","in":"query","schema":{"type":"string"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"zip","in":"query","schema":{"type":"string"}},{"name":"radius_miles","in":"query","schema":{"type":"integer"}},{"name":"price_min","in":"query","schema":{"type":"number"}},{"name":"price_max","in":"query","schema":{"type":"number"}},{"name":"year_min","in":"query","schema":{"type":"integer"}},{"name":"year_max","in":"query","schema":{"type":"integer"}},{"name":"classic_only","in":"query","schema":{"type":"boolean"}},{"name":"era","in":"query","schema":{"type":"string","enum":["pre_war","1950s","1960s","1970s","1980s","1990s_radwood","modern_classic"]}},{"name":"listing_type","in":"query","schema":{"type":"string","enum":["dealer_showroom","auction"]}},{"name":"build_style","in":"query","schema":{"type":"string","enum":["restomod","pro_touring","concours","survivor","original","restored","custom","driver"]}},{"name":"sort_by","in":"query","schema":{"type":"string","enum":["price","mileage","distance","newest"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Paginated vehicle search results with dealer VDP links and price-sanity verification."}}}},"/api/v1/vehicles/{idOrVin}":{"get":{"operationId":"getVehicleByIdOrVin","summary":"Get full vehicle details, fee audit breakdown, and insurance quote payload by VIN or ID","parameters":[{"name":"idOrVin","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Canonical vehicle record with fee breakdown and dealer metadata."}}}},"/api/v1/dealers":{"get":{"operationId":"listDealers","summary":"List participating and indexed dealerships across all 50 US states + DC","parameters":[{"name":"state","in":"query","schema":{"type":"string"}},{"name":"region","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Dealership coverage list with live New/Used/Classic counts."}}}},"/api/v1/deal-threads":{"post":{"operationId":"startShieldedInquiry","summary":"Start an anonymous Buyer Shield OTD inquiry with principal standing rules","responses":{"201":{"description":"Created shielded proxy thread or returned Buyer Shield software pass checkout link."}}}},"/api/v1/health":{"get":{"operationId":"getHealth","summary":"Live network coverage and health status","responses":{"200":{"description":"Network stats and health status."}}}}}}