Obtain API access through a formal business agreement; both Kelley Blue Book (b2b.kbb.com) and Black Book provide valuation data exclusively through partner or dealer subscription programs — there is no public self-service API.
Once credentialed, authenticate using the API key or OAuth 2.0 credentials provided by your partner agreement and direct API calls to the partner API base URL specified in your contract documentation.
Submit a valuation request by providing the VIN or a combination of year, make, model, trim, mileage, and condition grade; the API returns a structured response with retail, trade-in, and private-party values depending on the contracted data set.
Incorporate mileage and condition adjustments: most valuation APIs accept a mileage parameter and a condition enum (Excellent, Good, Fair, Poor) that modifies the base value.
Cache valuation responses with a short TTL (typically 24 hours or as specified in your contract); market values change daily and caching stale values can lead to incorrect appraisals.
For a no-agreement alternative during development, consider open-source vehicle valuation proxies or aggregators such as vehicledatabases.com, which resell or aggregate valuation data, subject to their own terms.
Known gotchas
KBB and Black Book valuation APIs are partner-gated and not publicly available; any public-facing or open-source library claiming to expose KBB data is either scraping, using a reseller, or violating terms of service.
Valuation data licensing is typically tied to a specific use case (dealer appraisal, consumer retail, finance/insurance); using data outside the licensed scope is a contract violation.
Values returned are market-based estimates, not guaranteed purchase prices; disclaim this to end users and do not present valuations as binding offers without an additional appraisal step.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp