What it returns
Official US Department of Transportation vehicle data in one call.
Common uses
Used-car listings and dealer tools, fleet management, insurance, auto parts e-commerce, consumer apps. Pay per result.
Request
POST https://api.pushbuild.com/vin-decoder-vehicle-recalls/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
vins | list of strings | 17-character VINs to decode (partial VINs decode what they can). |
vehicles | list of strings | Year make model, e.g. "2018 Honda Accord", for recalls and complaints. |
lookupDecodedVins | boolean | Also look up recalls (and complaints) for each decoded VIN's year, make and model. Default: true. |
includeRecalls | boolean | NHTSA safety recall campaigns. Default: true. |
includeComplaints | boolean | Owner complaints filed with NHTSA. Default: false. |
maxComplaintsPerVehicle | integer | Newest first. Default: 100. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/vin-decoder-vehicle-recalls/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"vins": ["1HGCM82633A004352", "5YJ3E1EA7KF317000"], "vehicles": ["2018 Honda Accord"], "maxItems": 20}'
Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}
Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.40 per 1,000 results. No charge for errors or empty searches.
Related APIs
Academic Papers Search API
Search scholarly papers across Crossref (150M+ works), arXiv and PubMed in one run.
Article & Web Page to Markdown API
Turn any URLs into clean, Markdown, text or JSON.
Book Search API
Search millions of books by keyword, title, author, subject or ISBN, plus author lookup.
College Scorecard: US Colleges, Costs, Earnings by Major API
Every US college from the Department of Education College Scorecard: admission rate, SAT/ACT, tuition, net price, completion and retention, median debt and graduates' earnings, plus program-level (major) debt and earnings 1 to 5 years after graduation..
Currency Exchange Rates API
Official European Central Bank reference exchange rates for 30+ currencies, daily since 1999.
CVE Vulnerability Lookup: NVD, CISA KEV, EPSS, OSV API
Look up CVEs by ID or keyword, or check open-source packages for known vulnerabilities.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com