One vehicle, the full record
GET · demo/vehicle_risk{ "status": "ready" }The Used Car Index data feed brings together NHTSA vehicle records, verified sales-denominator rates where available, and observed listing changes in a JSON API and remote MCP server.
Edit the query, then run it against this origin. The free vehicle lookup uses a shared, rate limited demo quota. Compare and listing examples require your own key. Responses include the HTTP status, elapsed time and current rate-limit window.
{ "status": "ready" }{ "status": "ready" }{ "status": "ready" }Send Authorization: Bearer <key> or X-API-Key: <key>. Keep private keys on your server. The free lookup keeps its demo credential on the server. Real use needs your own key; the playground never stores it.
Get a key: choose Starter, Builder, Scale or the two-week pilot at https://theusedcarindex.com/#pricing. Your key appears on screen once, right after payment.
Authorization: Bearer <key> Accept: application/json
Public discovery routes: /, /healthz, /openapi.json, /llms.txt, /.well-known/mcp/server-card.json, /.well-known/security.txt and /v1/demo/vehicle_risk.
All data endpoints return JSON. Every response includes X-Request-Id. Authenticated responses are not cached. A missing, unprocessed or unverified value stays null or has an explicit reason; it is never an inferred zero.
make and model (trimmed, 1–64 characters), year (2000–2027). Model spellings resolve through stored spellings, rule aliases in model_aliases, then the exact family key. matched_models lists the vehicle's own NHTSA labels that carry complaints, or all of its own labels with count 0 when the vehicle has no complaints; other_names lists zero-count own labels of a vehicle that has complaints and alternate NHTSA labels, including lookup-only aliases. Matched counts sum to complaints.total. Unknown vehicles return 404 and up to ten database suggestions.vehicles=toyota:rav4:2018,honda:cr-v:2018 (URL-encode the query). POST: {"vehicles":[{"make":"Toyota","model":"RAV4","year":2018},{"make":"Honda","model":"CR-V","year":2018}]}. Supply 2–5 vehicles, bounded by the plan’s max_compare. Each vehicle costs one unit. Unresolved items are marked not_found and remain unrated.make, model, year, uppercase 17-character vin, event_type (new, price_drop, relisted, delisted), inclusive since and until (YYYY-MM-DD), limit (1–200; default 50), cursor. Reuse next_cursor with the same filters. Newest date first, then descending event id. No active collectors returns an empty feed on a fresh database.make, model, year, type (recall, investigation, complaint_count), inclusive since and until on observed_date, limit (1–200; default 50) and cursor. Costs one unit. The same data is the recall_changes MCP tool; the keyless tier returns at most 10 changes and no paging.{"make":"Toyota","model":"RAV4","year":2018} to watch a vehicle; GET lists your entries and cap; DELETE with id or make, model and year removes one. No usage charge.resume_cursor as cursor next time. Optional type and limit. Costs one unit. There is no email or webhook delivery.download=1 returns the same JSON as an attachment. Supports ETag and a five-minute public cache.model_aliases, then the exact family key. matched_models lists the vehicle's own NHTSA labels that carry complaints, or all of its own labels with count 0 when the vehicle has no complaints; other_names lists zero-count own labels of a vehicle that has complaints and alternate NHTSA labels, including lookup-only aliases. Matched counts sum to complaints.total. Top system counts are distinct records. One record can name several systems, so shares across systems can add to more than 100 percent; a single share never exceeds 100 percent. Missing subsystem values are omitted.by_system row requires system, subsystem, source_field and count; subsystem is the empty string, meaning all subsystems of this system. by_subsystem holds the non-empty subsystem rows, at most 25. Up to ten recent communications retain metadata arrays.model_tags_null_reason is no_complaints, model_year_not_tagged or no_tagged_complaints; it is null when tags exist.coverage_complete: true means NHTSA has no complaint record for that vehicle year in this build. With coverage_complete: false, zero is not confirmed and the notes give the reason. Generated vehicle notes retain their sequence order. A requested alternate label is explained before those notes, with its API complaint count when above zero.These plans are read from this database on every page request. Vehicle and listing calls cost one unit; comparisons cost the number of requested vehicles. Input errors cost nothing. Admitted requests, including not-found results, increment all three UTC counters together. Over-limit requests do not change counters or daily accounting.
| Plan | / minute | / day | / month | Compare max | MCP |
|---|---|---|---|---|---|
| Free | 20 | 200 | 2,000 | 5 | Yes |
| Starter | 30 | 1,000 | 10,000 | 5 | Yes |
| Builder | 60 | 5,000 | 100,000 | 5 | Yes |
| Demo | 60 | 5,000 | 100,000 | 5 | Yes |
| Scale | 300 | 50,000 | 1,000,000 | 5 | Yes |
X-RateLimit-Limit, Remaining and Reset describe the window with the lowest fraction remaining (earliest reset breaks ties). Reset is a Unix timestamp in seconds. X-RateLimit-Window names it. Public discovery and unauthenticated responses use 0 / 0 / 0 and window none. The demo lookup reports shared plan headers. A 429 adds Retry-After in seconds until the earliest exceeded window resets; another exceeded window may still block the next call.
HTTP errors use RFC 9457 application/problem+json with a stable code. Input problems list field names without echoing values. MCP uses a JSON-RPC error envelope; tool failures carry the problem in error.data. SDK JSON-RPC errors keep HTTP 200; error.data.status always equals the HTTP status. Transport-level refusals retain their 4xx status. Binding denials use problem+json and Retry-After.
{
"type": "urn:carindex:problem:vehicle_not_found",
"title": "vehicle not found",
"status": 404,
"detail": "No vehicle matches the supplied make, model and year.",
"code": "vehicle_not_found",
"suggestions": []
}400 invalid input · 401 missing/invalid/revoked key · 403 MCP unavailable on plan · 404 unknown route or vehicle · 405 method not allowed · 413 body too large · 415 wrong media type · 429 cap exceeded · 500 internal error · 503 service or data unavailable. Public request bodies are capped at 64 KB.
Endpoint: https://api.theusedcarindex.com/mcp. Stateless Streamable HTTP, POST only, JSON responses. initialize, ping and tools/list are public. tools/call works without a key on a free read-only tier (20 requests per minute per IP, 2,000 per day shared, at most 2 vehicles per comparison, 10 listing events per call, no paging); a key lifts those limits and consumes the same quota as HTTP. The Accept header is optional. No session id or SSE subscription is required.
Use this mcp-remote bridge configuration, replacing <key> with your API key:
{
"mcpServers": {
"carindex": {
"command": "npx",
"args": [
"mcp-remote",
"https://api.theusedcarindex.com/mcp",
"--header",
"Authorization: Bearer <key>"
]
}
}
}{
"url": "https://api.theusedcarindex.com/mcp",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer <key>",
"Accept": "application/json, text/event-stream"
}
}Send Content-Type: application/json and a JSON-RPC 2.0 body. Discovery: server card.
Read-only tools: vehicle_risk {make, model, year}, compare_vehicles {vehicles}, listing_changes {make?, model?, year?, vin?, event_type?, since?, until?, limit?, cursor?}. Jev tags exist for model years 2012 and newer; model year 2012 is only partly tagged and earlier model years carry no tags. tagged_share gives each vehicle's tagged fraction; about 43 percent of all complaints are tagged. Each returns JSON text and matching structuredContent, without a verdict.
API contract 1.1.0 (2026-10-07) retains the /v1/ paths. The repository changelog is workers/api/CHANGELOG.md, with the complete 1.1.0 changes and the 1.0.0 launch entry.
Added other names, rule-alias resolution, tag null reasons, communications by subsystem and the security contact. matched_models lists the vehicle's own NHTSA labels that carry complaints, or all of its own labels with count 0 when the vehicle has no complaints; other_names lists zero-count own labels of a vehicle that has complaints and alternate NHTSA labels, including lookup-only aliases. System rows retain subsystem: "" for launch compatibility. Counts use distinct records and model-year family merges. Coverage and alternate-label notes explain the record; confirmed zeros require complete coverage. Tag notes distinguish a single partial year from a range. MCP Accept is optional, and error status matches HTTP. Public routes support HSTS, HTTPS redirects and HEAD. Enumerations may gain values in minor versions; clients must treat unknown values as opaque.
No photos, no dealer text. Delisted is never sold. No repair advice, no rating or verdict. A listing’s disappearance does not establish a completed transaction. The feed does not claim complete coverage where inputs are partial.