EV Reference Data — Schema
This page lists the main fields shipped in the sample CSV/JSON and the demo API.
Vehicle specs
model
— Make / model / trim (string)battery_kwh
— Usable capacity (kWh, numeric)wltp_mi
— WLTP range (miles, numeric)efficiency_kwh_per_100mi
— Energy use per 100 miles (numeric)ac_kw
/dc_kw
— Max AC/DC charging power (kW, numeric)otr_price_gbp
— On-the-road price inc. VAT (GBP, numeric)
Fleet & UK-specific inputs
bik_percent_2025
— EV BiK schedule 2025→ (string, e.g. "3–5%"; vans follow different rules)ved_y1_gbp
/ved_y2plus_gbp
— VED year-1 and years 2+ (GBP)ecs_applicable
— Expensive Car Supplement applies if list > £40k (boolean)hmrc_aer_p_per_mile
— Advisory Electricity Rate (pence per mile, numeric)ulez
— "Compliant" if exempt from ULEZ charge (string)cc_exempt_y1_if_cvd
— Congestion Charge £0/day in year-1 if CVD registered and active (boolean)residual_3y_pct
— Residual value at 3 years as % of OTR (numeric)maint_ev_gbp_per_mile
— Maintenance assumption (£ per mile, numeric)
Scope: evaluation dataset for UK fleets. We’ll extend with LCV/depot profiles and real-world cost data.