Bulk import & API
Shops, auctions, dealers and data suppliers can add records in bulk: repair orders, lot sheets, inspection exports, title feeds, photo folders and video. We read every file, match it to the right VIN and check each VIN's check digit. Records stay private until an administrator approves them.
What each row needs
You can correct any column match before you submit.
How it works
Every batch is reviewed by an administrator before anything is published.
Name the supplier and pick the type of records. Up to 5 batches can be open at once.
Duplicates are spotted in your browser, then files upload with live progress for each one.
Fix column matches, confirm VINs, and see which rows were accepted or rejected, and why.
The batch stays private while an administrator checks your business and the records.
Approved records appear on each vehicle's VIN Passport under your name.
Templates
Any column names work, but these templates match with no corrections at all.
vin, service_date, odometer, description, invoice, total, shopDownload service-records.csv vin, sale_date, lot, odometer, announcement, hammer_price, auction_houseDownload auction-lots.csv vin, inspected_at, odometer, findings, inspector, report_refDownload inspections.csv vin, event_date, jurisdiction, event, brand, odometer_disclosureDownload title-events.csv vin, captured_at, angle, filename, odometerDownload photos-manifest.csv One record per line, using any of the columns aboveDownload records.jsonl API & command line
The winbyvin command-line tool uses the same API as the studio. It skips files you've already sent, uploads several at once and picks up where it left off if the connection drops.
npx winbyvin import ./exports/*.csv ./photos/ \ --key $WBV_PARTNER_KEY \ --supplier "Your business name" \ --channel inspection
POST /api/ingest/batchesStart a batch with a record type and supplier namePOST /api/ingest/batches/:id/filesUpload files (up to 50 per request)POST /api/ingest/batches/:id/mappingCorrect a column match and re-check the rowsPOST /api/ingest/batches/:id/commitSubmit the batch for reviewGET /api/ingest/batches/:idStatus and the result for every rowx-partner-key headerYour key, issued to verified suppliersSending data at volume? See Enterprise Data