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.
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
/api/v1/model/honda/civic/2015.202 with retry_in while compiling.report_token from /plate — the VIN is revealed on purchase.report_token. Costs one lookup credit on a match, nothing on a miss.checkout_url a human opens to pay. Body {"quantity": N}. After payment, poll /balance.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
/report the body carries a buy block with pack prices and the /checkout endpoint.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.