For developers & AI agents

Vehicle Data API

One call returns everything on record for a VIN or a model year: specs, equipment, NHTSA recalls and complaints, crash-test ratings, EPA fuel economy, market value and cost to own — as clean JSON, from official sources.

Get an API key → OpenAPI spec

Pricing

$5.00 buys 1,000 calls ($0.005 each). Credits never expire. You are only charged for successful lookups — errors and VINs we can't decode cost nothing.

CarLogs Pro ($39.95/month) includes 1,000 calls a month on your key, used before any prepaid credits, a 120 requests/minute limit, and the /report endpoint — the full vehicle history report (title, odometer, salvage, liens, valuation) as JSON for up to 10 VINs a month.

Quick start

Send your key as a bearer token:

curl -H "Authorization: Bearer YOUR_KEY" \
  https://carlogs.xyz/api/v1/vehicle/3HGGK5H41JM732361

Endpoints

GET /api/v1/vehicle/{VIN}
Decode, equipment, base MSRP, recalls, complaints, safety ratings, fuel economy, market value, cost to own.
GET /api/v1/model/{make}/{model}/{year}
The same model-level data without a VIN, e.g. /api/v1/model/honda/civic/2015.
GET /api/v1/report/{VIN}
The full history report as JSON: title status and brands, title/registration records, odometer readings and rollback check, accident indicators, total-loss, salvage, theft, liens, per-VIN recall status, market value and specifications. Costs one report credit ($13.95); re-reading a VIN you already bought costs nothing, and Pro members use their monthly report allowance first. Returns 202 with retry_in while compiling.
GET /api/v1/report?pt={token}
Same full report for a plate match, using the report_token from /plate — the VIN is revealed on purchase.
GET /api/v1/plate?country=&state=&plate=
Resolve a US or Canadian licence plate to a vehicle teaser (year, make, model — no VIN) plus a report_token. Costs one lookup credit on a match, nothing on a miss.
POST /api/v1/checkout
Buy report credits — returns a Stripe checkout_url a human opens to pay. Body {"quantity": N}. After payment, poll /balance.
GET /api/v1/balance
Remaining lookup credits, Pro allowance, report credits and pack prices.
GET /openapi.json
Machine-readable spec (no key needed) — import into your HTTP client or give it to an AI agent.

For AI agents — MCP

CarLogs runs a Model Context Protocol server at https://carlogs.xyz/mcp (Streamable HTTP, JSON-RPC 2.0). Point any MCP client — Claude, ChatGPT, Cursor and others — at it with your API key as a bearer token. Tools: decode_vin, lookup_plate, get_history_report, buy_report_credits, account_balance. Discovery: https://carlogs.xyz/.well-known/mcp.json. An agent can decode a VIN or plate, see the price, have a person approve a credit purchase, then pull the full report — end to end.

Example response

{
  "vin": "3HGGK5H41JM732361",
  "vehicle": { "year": 2018, "make": "Honda", "model": "Fit", "trim": "LX", "base_msrp_usd": 16190, ... },
  "equipment": { "standard": ["Anti-lock brakes (ABS)", "Backup camera", ...], "optional_on_this_build": [...] },
  "recalls": { "count": 4, "scope": "model_year", "campaigns": [ { "campaign": "...", "component": "...", "summary": "...", "remedy": "..." } ] },
  "complaints": { "count": 112, "top_areas": [ { "area": "Forward Collision Avoidance", "reports_in_sample": 5 } ] },
  "safety_ratings": { "overall": 5, "frontal": 5, "side": 5, "rollover": 4, "scale": "1-5 stars" },
  "fuel_economy": { "combined": 33, "city": 31, "highway": 37, "unit": "mpg", "annual_fuel_cost_usd": 1850 },
  "market_value": { "low_usd": 13995, "typical_usd": 17261, "high_usd": 19995, "sample_size": 42 },
  "ownership_cost_5yr": { "fuel_usd": 9250, "depreciation_usd": 5200, "total_usd": 14450, "per_mile_usd": 0.19 },
  "sources": { "recalls": "NHTSA", "fuel_economy": "U.S. EPA / DOE fueleconomy.gov", ... },
  "notice": "Vehicle data only. CarLogs never provides owner or keeper information."
}

Errors

401
Missing or invalid API key.
402
Out of credits. On /report the body carries a buy block with pack prices and the /checkout endpoint.
404
VIN or model year not found. Not charged.
429
More than 60 requests per minute. Check Retry-After.

Lookups carry an X-Credits-Remaining header (plus X-Pro-Calls-Remaining on Pro keys); reports carry X-Report-Credits-Remaining.

What the data is — and isn't

Specifications come from NHTSA vPIC; recalls, complaints and crash-test ratings from NHTSA; fuel economy from the U.S. EPA; value ranges from CarLogs listing data. Recalls are campaigns for the model year — the API does not say whether an individual car has had the repair done.

The API returns vehicle data only. It never returns owner, keeper or registration-holder information. Title, salvage and odometer history are available to Pro members through /report.