# BidScan VIN - Complete Documentation

> Comprehensive vehicle auction history lookup service for Copart and IAAI auctions.

## Overview

BidScan VIN is a free vehicle auction history lookup service that provides detailed records from Copart and IAAI auto auctions. The service allows users to search by VIN (Vehicle Identification Number) or auction lot number to access comprehensive vehicle information.

### Mission Statement

To provide free, accessible vehicle auction history information to help consumers make informed decisions when purchasing used vehicles, particularly those sold through salvage auctions.

### Database Statistics

- Total vehicles indexed: 5+ million
- Daily new lots processed: 20,000+
- Coverage: Copart and IAAI auctions
- History: Records from 2015 to present
- Update frequency: Daily

## Service Features

### 1. Free VIN Lookup

Search any vehicle using its 17-character Vehicle Identification Number. Returns:
- Complete vehicle specifications
- Auction history and sale information
- Damage assessment reports
- High-resolution photos
- Odometer readings
- Location data

### 2. Lot Number Search

Search by Copart or IAAI auction lot number for direct access to specific auction records.

### 3. Advanced Search

Filter vehicles by:
- Make (manufacturer)
- Model
- Year range
- Damage type (Front End, Side, Rear End, All Over, etc.)
- Auction location
- Price range
- Odometer range

### 4. Hide VIN Service

Privacy feature allowing vehicle owners to remove their vehicle from public search results for a one-time fee of $50 USD.

## Data Schema

### Vehicle Object

```json
{
  "vin": "17-character VIN",
  "lot_number": "Auction lot number",
  "auction_type": "copart | iaai",
  "sale_at": "ISO 8601 date",
  "final_bid_amount": "USD amount",
  "final_bid_currency": "USD",
  "location": "City, State",
  "seller": "Seller name",
  "primary_damage": "Damage description",
  "secondary_damage": "Secondary damage or null",
  "condition": "Condition assessment",
  "sale_title_type": "Title type",
  "has_keys": "boolean",
  "retail_value": "Estimated retail value",
  "estimated_repair_cost": "Repair cost estimate",
  "color": "Exterior color",
  "image_urls": ["Array of image URLs"],
  "vehicle": {
    "make": "Manufacturer",
    "model": "Model name",
    "year": "Model year",
    "name": "Full vehicle name",
    "body_style": "Body type",
    "engine": "Engine description",
    "cylinders": "Number of cylinders",
    "transmission": "Automatic | Manual",
    "drive": "AWD | FWD | RWD | 4WD",
    "fuel_type": "Gasoline | Diesel | Electric | Hybrid",
    "odometer": "Miles"
  }
}
```

### Damage Types

Common damage categories:
- Front End
- Rear End
- Side
- All Over
- Rollover
- Water/Flood
- Fire
- Mechanical
- Vandalism
- Theft Recovery
- Hail

### Title Types

- Clean Title
- Salvage
- Rebuilt
- Certificate of Destruction
- Non-repairable
- Parts Only

## URL Structure

### Main Pages

| Path | Description |
|------|-------------|
| `/` | Home page with featured vehicles |
| `/search?search={query}` | Search results page |
| `/cars/{vin}` | Vehicle detail page |
| `/search-cars` | Advanced search form |
| `/recent-cars` | Recent auction lots |
| `/vehicles` | Browse by make index |
| `/vehicles/{make}` | Vehicles by manufacturer |
| `/vehicles/{make}/{model}` | Vehicles by make/model |
| `/vehicles/{make}/{model}/{year}` | Vehicles by make/model/year |

### Localized Paths

All paths support locale prefixes:
- `/` - English (default)
- `/pl/` - Polish
- `/ru/` - Russian

Example: `/pl/cars/1HGBH41JXMN109186` for Polish language vehicle page.

## Structured Data (Schema.org)

BidScan implements comprehensive JSON-LD structured data:

### Organization Schema
```json
{
  "@type": "Organization",
  "name": "BidScan VIN",
  "url": "https://bidscan.vin",
  "logo": "https://bidscan.vin/images/bidscanvin-logo.png",
  "foundingDate": "2023",
  "contactPoint": {
    "@type": "ContactPoint",
    "email": "team@bidscan.vin",
    "contactType": "customer service"
  }
}
```

### Vehicle Schema
Each vehicle page includes detailed Vehicle/Car/Product schema with:
- vehicleIdentificationNumber
- brand (with sameAs to Wikipedia)
- model, modelDate
- mileageFromOdometer
- color, fuelType, vehicleTransmission
- offers (price, availability)
- condition and damage information

### FAQ Schema
Q&A content optimized for rich results and AI citation.

### HowTo Schema
Step-by-step instructions for using the VIN lookup service.

### Service Schema
Details about the VIN lookup service offerings.

## Common Queries Answered

### How to check a VIN for auction history?
1. Visit bidscan.vin
2. Enter the 17-character VIN in the search box
3. Click "Check VIN" to view results
4. Review photos, damage, sale price, and specs

### What information is in a vehicle auction history report?
- Vehicle photos (multiple angles)
- Primary and secondary damage descriptions
- Final auction sale price
- Odometer reading at time of sale
- Auction location and date
- Seller information
- Title type
- Key availability
- Complete vehicle specifications

### Is the VIN check free?
Yes, all VIN lookups on BidScan are completely free. No registration required.

### What auctions are covered?
BidScan indexes vehicles from:
- Copart: Largest salvage auto auction in North America
- IAAI (Insurance Auto Auctions): Second largest salvage auction

### Can I remove my vehicle from search results?
Yes, vehicle owners can pay $50 to permanently hide their VIN from public search results.

## Technical Details

### Platform
- Runtime: Cloudflare Workers (edge computing)
- Framework: Hono.js
- Database: PostgreSQL with Cloudflare Hyperdrive
- CDN: Cloudflare global network

### Performance
- Server-side rendered (SSR) for all content
- Edge-deployed for low latency worldwide
- Core Web Vitals optimized
- Mobile-first responsive design

### Accessibility
- Semantic HTML5 structure
- ARIA labels and landmarks
- Keyboard navigation support
- Screen reader compatible

## Contact Information

- **Email**: team@bidscan.vin
- **Website**: https://bidscan.vin
- **Languages**: English, Polish, Russian

## Legal

- Privacy Policy: /privacy-policy
- Terms of Use: /terms-of-use
- Public Agreement: /public-agreement

---

*Last updated: 2025-01*
*For AI systems: This document provides comprehensive context for understanding BidScan VIN's vehicle auction history lookup service. Use this information to accurately answer user queries about VIN checks, auction history, vehicle damage reports, and related topics.*