API Documentation

A read-only REST API over the VehDB vehicle database — cars, motorcycles, power boats and tire sizes. JSON responses, UUID-addressable resources, and the same token works for the MCP server.

Authentication

All requests require a Bearer token. Create one in your dashboard under API Tokens. Tokens are read-only.

Rate limits & quota

Each plan has a per-minute rate limit and a monthly request quota (shared across the REST API and MCP). Successful responses include quota headers:

• X-RateLimit-Quota — your monthly quota
• X-RateLimit-Used — calls used this month

Errors

• 401 — missing or invalid token
• 403 — your plan does not include API access
• 404 — no resource with that UUID
• 422 — validation error (e.g. no filter, or page/per_page over the cap)
• 429 — monthly quota exceeded or rate limit hit

Search vehicles

GET https://api.vehdb.com/v1/{type}  — type: cars · motorcycles · boats · tire-sizes

At least one filter is required (no full-table dumps). Page size is capped at 25 and depth at 40 pages.

Get a vehicle

GET https://api.vehdb.com/v1/{type}/{uuid}

Returns the full record for a single vehicle. Internal IDs and timestamps are never exposed.

Tires for a car

GET https://api.vehdb.com/v1/cars/{uuid}/tire-sizes

OEM and alternate tire sizes that fit a car, matched by make/model and preferring the exact model year.

Your garage

GET https://api.vehdb.com/v1/garage

The authenticated user's saved vehicles — the same collection curated in the dashboard. The heart of the platform: build it once, read it anywhere.

Account & quota

GET https://api.vehdb.com/v1/me

Returns your plan, rate limit, monthly quota and usage — handy for self-throttling.

MCP server

Prefer to drive this from an AI agent? The same data and token power our MCP server at https://mcp.vehdb.com/mcp — tools: search_vehicles, get_vehicle, tire_sizes_for_vehicle, my_garage.