Skip to content

OpenEV Data

OpenEV Data Logo

The Single Source of Truth for Electric Vehicle Specifications.

The primary goal of OpenEV Data is to develop and maintain the world's most accurate, scientifically validated, and accessible open database of Electric Vehicle (EV) specifications. Unlike fragmented proprietary lists, OpenEV is built on Data-as-Code principles, ensuring version control, strict schema validation, and community review for every data point—from battery chemistry to charging curves.

Our infrastructure is powered by a high-performance Rust ecosystem. The API provides global low-latency access to data, while the dataset itself is agnostic and available for direct download in JSON or SQL formats.

We aim to speed up eMobility adoption by providing developers, researchers, and charging network operators with a reliable standard (The "OpenEV Spec") to build better routing algorithms, chargers, and apps.

Repository Structure

OpenEV Data is modular by design to separate concerns between data curation and software engineering.

Repository Description Tech Stack
open-ev-data-dataset The core database. Contains all vehicle JSONs and validation schemas. JSON, JSON Schema
open-ev-data-api The high-performance engine. Handles ETL, SQL generation, and the API. Rust
open-ev-data.github.io Official documentation, guides, and API reference. MkDocs, Material
.github Governance, organization-wide policies, and issue templates. Markdown

Getting Started

To start consuming the data or contributing to the project, please read our Documentation.

Project Status

Technical Overview

  • Strict Typing: All data is validated against rigorous JSON Schemas (vehicle.schema.json) before merging.
  • Deep Merge Architecture: Uses a hierarchical inheritance model (Base -> Year -> Trim) to ensure DRY (Don't Repeat Yourself) data entry.
  • High Performance: The API is optimized for low-latency global access using efficient Rust infrastructure.
  • Rust Core: All tooling (ETL, Validation, Server) is written in Rust for safety and performance.

Roadmap

See our technical roadmap on our project website.

Supported Standards

OpenEV Data standardizes specifications across multiple global charging standards:

  • CCS2 (EU/Global)
  • NACS / J3400 (North America/Tesla)
  • CCS1 (North America Legacy)
  • GB/T (China)
  • CHAdeMO (Japan/Legacy)
  • Type 2 / Type 1 (AC Charging)

Contributing

We welcome contributions from EV enthusiasts, engineers, and manufacturers. Precision is our priority.

  • To add a vehicle: Please open a Pull Request in the open-ev-data-dataset repository using the provided templates.
  • To improve the API: Please check the issues in the open-ev-data-api repository.

Read our Contribution Guidelines before submitting.

Governance & Licensing

This project employs a dual-licensing strategy to best serve the ecosystem:

  1. Software (API/CLI): Licensed under the Apache License, Version 2.0. Safe for enterprise integration and patent protection.
  2. Database (Dataset): Licensed under the CDLA-Permissive-2.0 (Community Data License Agreement). Optimized for open data sharing and mining.
  3. Documentation: Licensed under CC-BY 4.0.

See LICENSE in each repository for specific details.

Support

If you identify a data error or a bug in the API, please open an issue using the appropriate template.

Contributors

Avatar Contributor Contributions
@jsrwell Project creator, architecture, API, dataset