For AI agents: llms.txt.

VIN lookup

Request example

POST/api/v1/vin
Scope
dossier
Formats
JSON · SSE
Sandbox
Free fixtures

Authorization

Authorizationheaderrequired

Send Bearer $DEEPSEARCH_API_KEY with the dossier scope. The free sandbox uses the published test key.

Body parameters

vinstringrequired

The 17-character Vehicle Identification Number (no I, O, or Q).

refreshboolean

Bypass the shared cache and rebuild.

Default: false

formatenum

json collects the result; sse streams progress and result events.

jsonsse

Default: json

sandboxboolean

Return deterministic, unmetered fixtures.

Default: false

Response

JSON responses preserve the operation result and include request metadata, usage, and collected events. SSE delivers progress and result events as they arrive.

Sources & coverage

Submit a 17-character VIN and get the decoded vehicle profile - year/make/model/trim, engine & drivetrain, body, assembly plant - plus open NHTSA recalls and crash-test safety ratings. Specs/recalls/safety are official NHTSA public data; title/accident history is included only where a history provider is configured. Public vehicle information only; not an FCRA report. Cached VINs are free.

Usage & caching

A paid fresh vehicle-history report is High usage and covers all nested work. Cached reports use no usage.

Examples illustrate the contract. Test request runs the selected deployment; sandbox fixtures are unmetered.

Skip to content