Skip to content
OpenEV Data Logo

OpenEV Data Dataset

A canonical, open dataset of electric vehicle specifications following a Layered Canonical Dataset (LCD) architecture.

License: CDLA-Permissive-2.0 Version

Overview

This repository provides a structured, versioned, and community-maintained dataset of electric vehicle specifications. Vehicle data is authored as layered JSON fragments and compiled into canonical, fully-expanded vehicle records suitable for analysis, comparison, and integration.

Documentation

Getting Started

  • How to Consume — Complete guide on using the dataset in all available formats with examples

Repository Documentation

  • Architecture — Repository architecture, layered data model, build process, and authoring rules
  • Schema Reference — Complete field-by-field documentation of the vehicle data schema
  • Contributing Vehicles — Step-by-step guide to add new vehicles and validate changes

Project Governance

  • Getting Started — How to set up the complete development environment with all repositories
  • Contributing Guide — How to contribute, data quality standards, and commit message guidelines
  • Code of Conduct — Community standards and expected behavior

Data Coverage

This dataset aims to cover: - Vehicle identity: Make, model, year, trim, and variant configurations - Battery system: Chemistry, capacity (gross/net), voltage, cell/module count, thermal management, warranty, preconditioning - Charging infrastructure: Charge ports (Type 1, Type 2, CCS1, CCS2, NACS, CHAdeMO, GB/T), location, and features - Charging capabilities: AC (power, phases, onboard charger), DC fast charging (peak power, voltage class, curves, protocols) - Bidirectional charging (V2X): V2L (Vehicle-to-Load), V2H (Vehicle-to-Home), V2G (Vehicle-to-Grid) - Range and efficiency: Rated cycles (WLTP, EPA, NEDC, CLTC, JC08), real-world estimates, energy consumption - Powertrain: Motor configuration, power, torque, drivetrain, transmission - Performance: Acceleration (0-100 km/h, 0-60 mph), top speed, quarter mile - Physical specifications: Dimensions, weight, cargo capacity, towing capacity - Wheels and tires: Sizes, recommended pressures - Market data: Availability status, markets (by country), pricing (MSRP) - Software: Operating system, OTA update support - Sources and metadata: Verifiable sources, data quality indicators, contributors

Use Cases

  • Research: EV market analysis, charging infrastructure planning
  • Applications: EV comparison tools, range calculators, charging time estimators
  • APIs: Backend data source for automotive applications
  • Education: Learning about EV technology and specifications

Quick Start

Download Latest Release

LATEST_TAG=$(curl -s https://api.github.com/repos/open-ev-data/open-ev-data-dataset/releases/latest | jq -r .tag_name)
curl -L -o open-ev-data.json "https://github.com/open-ev-data/open-ev-data-dataset/releases/download/$LATEST_TAG/open-ev-data-$LATEST_TAG.json"

Run with Docker Compose Latest Release Version

Start the complete stack with API and pre-populated database:

docker-compose up -d

Access the API at http://localhost:8080/api/v1/vehicles

See How to Consume for detailed usage examples in all formats.

License

This project is licensed under the Community Data License Agreement - Permissive, Version 2.0 (CDLA-Permissive-2.0).

In summary: - Free to use, modify, and share - No restrictions on results or derivatives - No warranty provided

See LICENCE for full terms.

Acknowledgments

This project is inspired by the need for open, structured, and verifiable EV data. Special thanks to all contributors who help maintain and improve this dataset.