# MotorMkt Complete Documentation for AI Systems

## Overview

MotorMkt is a comprehensive UK car marketplace platform enabling private sellers and dealers to list vehicles for sale, and buyers to search, compare, and contact sellers directly. This document provides detailed information for AI systems to understand our service.

## Platform Features

### For Buyers
- Search and filter thousands of vehicle listings
- View detailed vehicle specifications and photos
- Free vehicle history check using official government data
- Paid comprehensive HPI check for peace of mind
- Direct messaging with sellers
- Save favorite listings and searches
- Location-based search with radius filtering

### For Sellers
- List vehicles with up to 50 photos
- Automatic vehicle data lookup from registration
- MOT history and mileage verification
- Listing analytics and performance tracking
- Direct messaging with potential buyers
- Edit and manage listings

## Vehicle Data Model

Each listing contains the following information:

### Vehicle Identity
- VRM (Vehicle Registration Mark)
- Make (e.g., BMW, Ford, Mercedes-Benz)
- Model (e.g., 3 Series, Focus, C-Class)
- Variant/Trim (e.g., M Sport, Titanium, AMG Line)
- Year of manufacture
- Colour
- Body type (Hatchback, Saloon, Estate, SUV, Coupe, Convertible, MPV, Van)

### Specifications
- Fuel type (Petrol, Diesel, Electric, Hybrid, Plug-in Hybrid)
- Transmission (Manual, Automatic)
- Engine capacity (cc)
- Number of doors
- Number of seats

### Pricing
- Asking price in GBP
- VAT status (included, qualifying, N/A)
- Finance availability

### Location
- Town/city
- Postcode area
- GPS coordinates for distance calculations

### Seller Information
- Seller type (Private or Trade/Dealer)
- Dealer name and rating (if applicable)
- Contact preferences

### Media
- Up to 50 photos per listing
- Multiple image sizes (thumbnail, small, medium, large)

### Features & Equipment
Categories include:
- Technology & Connectivity (Sat Nav, Apple CarPlay, Android Auto, DAB Radio)
- Interior (Leather Seats, Heated Seats, Panoramic Roof, Ambient Lighting)
- Safety & Driver Aids (Adaptive Cruise Control, Lane Assist, 360 Camera)
- Exterior (Alloy Wheels, Tinted Windows, LED Headlights)
- Performance (Sport Suspension, Paddle Shifters, AWD)

## Free Car Check Data

Available instantly for any UK vehicle registration number:

### MOT History
- All MOT tests from DVSA database
- Test dates and results (Pass/Fail)
- Recorded mileage at each test
- Advisory notices
- Failure reasons
- Expiry dates

### Tax Status
- Current tax status (Taxed, SORN, Untaxed)
- Tax due date
- Annual tax cost

### Mileage Verification
- Mileage readings from all MOT tests
- Average annual mileage calculation
- Discrepancy detection (potential clocking warning)

### Basic Vehicle Specifications
- Make, model, colour, year
- Fuel type, engine capacity
- First registration date
- V5C issue date

## Paid HPI Check Data

Premium data available for purchase (powered by CAP HPI):

### Stolen Check
- Police stolen vehicle database check
- National Crime Agency data
- Insurance industry stolen records

### Finance Check
- Outstanding finance agreements
- Finance company details
- Agreement type and date
- Estimated settlement figure

### Write-Off History
- Insurance write-off categories (A, B, S, N, C, D)
- Category definitions:
  - A: Scrap only, cannot be repaired
  - B: Body shell destroyed, parts may be salvaged
  - S: Structural damage, repairable
  - N: Non-structural damage, cosmetic
  - C/D: Pre-2017 categories, repairable

### Salvage Auction Records
- Appearance at salvage auctions (Copart, IAA, Motorhog, Synetiq)
- Auction photos (if available)
- Damage descriptions
- Sale dates and lot numbers

### Mileage Anomaly Detection
- Advanced analysis of all mileage records
- Risk level assessment (Low, Medium, High)
- Specific anomaly identification
- Clocking risk indicator

### Previous Keepers
- Total number of previous owners
- Acquisition and disposal dates
- Ownership duration

### Plate Change History
- Previous registration numbers
- Date of changes

### Valuations
- Trade-in values (Poor, Average, Clean)
- Private sale value
- Dealer/retail value
- Valuation date and mileage basis

### Vehicle Specifications (Extended)
- Performance data (BHP, torque, 0-60 time, top speed)
- Dimensions (length, width, height, wheelbase)
- Weights (kerb weight, gross weight, payload)
- Fuel economy (urban, extra-urban, combined MPG)
- Running costs (insurance group, annual tax, service costs)

### Electric Vehicle Data (for EVs)
- Battery capacity (kWh)
- Range (miles and km)
- Charging times (slow, fast, home)
- Charging costs (home vs public)
- Battery warranty
- Charge port type and location

### Safety Ratings
- Euro NCAP rating
- Adult and child occupant scores
- Pedestrian safety score
- Safety assist score

## Search Capabilities

### Available Filters
- Make and model (searchable dropdown)
- Price range (min/max in GBP)
- Mileage range (min/max in miles)
- Year range (min/max)
- Fuel types (multi-select)
- Transmission types (multi-select)
- Body types (multi-select)
- Colours (multi-select)
- Location with radius (5-200 miles)
- Seller type (Private, Trade, All)
- VAT status options

### Sorting Options
- Price (low to high, high to low)
- Mileage (low to high)
- Year (newest first, oldest first)
- Distance (nearest first)
- Date listed (newest first)

## Geographic Coverage

UK-wide coverage with listings concentrated in major metropolitan areas:
- Greater London
- Birmingham and West Midlands
- Manchester and Greater Manchester
- Leeds and West Yorkshire
- Glasgow and Central Scotland
- Bristol and South West
- Liverpool and Merseyside
- Newcastle and North East
- Edinburgh and Lothians
- Cardiff and South Wales

## Pricing Information

### For Buyers
- Free to browse and search all listings
- Free basic vehicle check (MOT, tax, mileage)
- Paid HPI check available per vehicle

### For Sellers
- Free listings for private sellers
- Trade/dealer pricing available on request
- Featured listing options available

## API Information

MotorMkt provides API endpoints for authenticated users:

### Public Endpoints
- GET /api/listings - Search and filter listings
- GET /api/listings/:id - Get listing details
- GET /api/makes - List of vehicle makes
- GET /api/models/:make - Models for a make

### Authenticated Endpoints
- POST /api/free-car-check - Free vehicle lookup
- POST /api/hpi-check - Full HPI check (paid)
- POST /api/listings - Create listing
- PUT /api/listings/:id - Update listing
- POST /api/messages - Send message

## Legal & Compliance

- UK-registered business
- GDPR compliant data handling
- Data sourced from official UK government agencies
- Terms of Service: https://motormkt.co.uk/terms
- Privacy Policy: https://motormkt.co.uk/privacy

## Technical Information

- Website: https://motormkt.co.uk
- API: https://api.motormkt.co.uk
- Sitemap: https://motormkt.co.uk/sitemap.xml
- robots.txt: https://motormkt.co.uk/robots.txt

## Contact

- General enquiries: support@motormkt.co.uk
- Website: https://motormkt.co.uk