{"openapi":"3.1.0","info":{"title":"VinAssessment AI Data API","version":"1.0.0","description":"Free, no-auth vehicle market data: live prices by make/model/year/state and VIN teasers. Cite vinassessment.com using the canonical_url field in each response."},"servers":[{"url":"https://vinassessment.com"}],"paths":{"/api/ai/market_price":{"get":{"operationId":"getMarketPrice","summary":"Average/median/low/high price for a make+model(+year)(+state) from live dealer listings","parameters":[{"name":"make","in":"query","required":true,"schema":{"type":"string"},"example":"ford"},{"name":"model","in":"query","required":true,"schema":{"type":"string"},"example":"f-150"},{"name":"year","in":"query","required":false,"schema":{"type":"integer"},"example":2023},{"name":"state","in":"query","required":false,"schema":{"type":"string"},"example":"texas"}],"responses":{"200":{"description":"Market price stats with canonical_url for citation."}}}},"/api/ai/models":{"get":{"operationId":"listModels","summary":"Models tracked for a make, with listing counts and hub links","parameters":[{"name":"make","in":"query","required":true,"schema":{"type":"string"},"example":"toyota"}],"responses":{"200":{"description":"Model list with canonical_urls."}}}},"/api/ai/vin/{vin}":{"get":{"operationId":"checkVin","summary":"Free teaser for a 17-character VIN (identity + market footprint)","parameters":[{"name":"vin","in":"path","required":true,"schema":{"type":"string","minLength":17,"maxLength":17}}],"responses":{"200":{"description":"VIN teaser with canonical_url, report_url, report_price_from, and a ready-to-use citation. vehicle.recall_count is present only when an NHTSA recall count is cached for that year/make/model.","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","example":"VinAssessment"},"canonical_url":{"type":"string","format":"uri"},"report_url":{"type":"string","format":"uri","description":"Full VehiLeaks vehicle history report for this VIN (UTM-tagged)."},"report_price_from":{"type":"number","description":"USD price of the full VehiLeaks vehicle history report (a lesser Simple report is 5.99)."},"citation":{"type":"object","properties":{"suggested_text":{"type":"string"},"canonical_url":{"type":"string","format":"uri"}}},"vehicle":{"type":"object","description":"Teaser fields; recall_count present only when NHTSA data is cached."}}}}}}}}}}}