{ "openapi": "3.0.1", "info": { "title": "VIN Decoder API: Bulk NHTSA Lookup, Specs & Recalls", "description": "Decode thousands of VINs with official NHTSA data: make, model, year, trim, engine, plant. Check digit and model year verified, makers' own 2026 VIN codes, optional recalls, complaints and 5-Star crash ratings. Flat CSV. From USD 1.00 per 1,000 VINs.", "version": "1.0", "x-build-id": "7aZkvPqfdnNeH7T09" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/usefulapi~vin-decoder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-usefulapi-vin-decoder", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/usefulapi~vin-decoder/runs": { "post": { "operationId": "runs-sync-usefulapi-vin-decoder", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/usefulapi~vin-decoder/run-sync": { "post": { "operationId": "run-sync-usefulapi-vin-decoder", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "vins": { "title": "VINs", "type": "array", "description": "One VIN per line (17 characters; spaces, dashes and lower case are fine). Paste thousands at once with Bulk edit. Add a model year after the VIN if you know it (1HGCM82633A100000, 2003). Text that is not a VIN (a make, a price, a stock number) is skipped and not billed. Duplicates are decoded once.", "items": { "type": "string" } }, "vinListUrl": { "title": "Or a file of VINs (URL)", "type": "string", "description": "Link to a .txt or .csv file (up to 5 MB), for example a Google Sheet published as CSV (File > Share > Publish to web > CSV). The VIN column is found by its header (VIN, Vehicle Identification Number...) or by its content; a Year or Model year column is used when present. Web pages and Excel files are refused (save as CSV). Can be used together with the list above." }, "nhtsa": { "title": "Decode at NHTSA", "type": "boolean", "description": "Look each VIN up in NHTSA's official vPIC database (make, model, trim, engine, plant and about 140 more fields), 50 VINs per request. Off = offline check only: format, check digit, model year code, sections and the maker's filing, billed at the lower check price.", "default": true }, "recalls": { "title": "Recalls", "type": "boolean", "description": "Add the recall campaigns NHTSA lists for each vehicle's make, model and model year (count, campaign numbers, park-it and park-outside warnings). NHTSA's public data works by model year, not by VIN: it does not say whether this exact car is affected or already repaired. Billed per row that gets an answer.", "default": false }, "complaints": { "title": "Complaints", "type": "boolean", "description": "Add a summary of the complaints owners filed with NHTSA for the make, model and model year: count, crashes, fires, injuries, deaths and the 5 most named components. Billed per row that gets an answer.", "default": false }, "ratings": { "title": "Crash test ratings", "type": "boolean", "description": "Add NHTSA's 5-Star Safety Ratings for the vehicle's model year and version: overall, front crash, side crash, side pole and rollover stars, and the rollover risk. The rated version is matched on drive, doors and cab; when several versions fit with different stars, they are all listed and the row is not billed. Billed per row that gets one rating.", "default": false }, "details": { "title": "Nested details", "type": "boolean", "description": "Also add every non-empty NHTSA field (nhtsaFields), the maker's filing position by position (makerFiling) and each recall's text, remedy and date (recalls). Bigger rows; best for JSON. Same price.", "default": false }, "fixIoq": { "title": "Fix I, O and Q", "type": "boolean", "description": "VINs never use I, O or Q. When a VIN has them and reading I as 1 and O or Q as 0 gives a correct check digit, decode the corrected VIN (the row says so). Off = report such VINs as invalid with the suggestion.", "default": true }, "dedupe": { "title": "Decode duplicates once", "type": "boolean", "description": "The same VIN (and model year) given twice gets one row. Off = one row (and one charge) per line.", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }