API Changelog

Every change to the REST API and MCP server lands here. Versioning promise: additive changes (new endpoints, new fields) ship without notice; breaking changes are announced at least 30 days ahead — by email to active API users and on this page — and the previous behavior stays available under /v1 until the sunset date.

June 12, 2026

Changed
  • API tokens are now TEAM-scoped (Stripe-style account keys): tokens are created and managed per team, and quota/rate limits follow the team's plan.
  • GET /v1/me now returns the acting team's name alongside plan and quota.
  • GET /v1/lists returns the acting team's lists.

June 12, 2026

Added
  • GET /v1/cars/{uuid}/recalls — live NHTSA recall campaigns + NCAP crash-test ratings per car.
  • GET /v1/motorcycles/{uuid}/recalls — NHTSA recall campaigns for motorcycles.
  • GET /v1/tire-sizes/{uuid}/geometry — computed OEM size geometry and alternate-size diameter deltas (±3% fitment window).
  • EPA enrichment fields on car records: mpg_city, mpg_highway, mpg_combined, epa_range_miles, annual_fuel_cost, co2_gpm (null where EPA has no data).
  • Machine-readable OpenAPI 3.1 description at /openapi.json.

June 11, 2026

Added
  • MCP server endpoint at mcp.vehdb.com/mcp (path fallback /mcp/vehicles remains).
  • API vanity domain api.vehdb.com/v1 (path fallback /api/v1 remains).
  • MCP tools: search_vehicles, get_vehicle, my_lists, tire_sizes_for_vehicle.
  • OAuth2 (dynamic client registration) for AI providers, alongside Bearer tokens.
  • GET /v1/cars/{uuid}/tire-sizes — car → tire fitment cross-reference.
  • GET /v1/lists — the authenticated user's curated vehicle list.
Want changes in your inbox? Active API customers get breaking-change notices automatically. Questions: [email protected]