API contractOPENAPI 3.1Machine-readable and versionedDownload specification →

API access

API access requires approval. The datasets and coverage described below help you assess whether the data fits your needs.

Response contract

Evidence travels with the result

data
The requested records. An empty array means the requested dimension is not available; it is not replaced with another dataset.
source
Official organisation and, where available, the original source URL.
latest_available_period
The newest validated reporting month currently known to the API.

Version 1

Endpoints

GET · JSON · read only

Available reporting periods

Validated reporting periods for constructing time-series queries.

No parameters
/api/v1/periodsAPI key required

Search

Search available market entities.

q (2–80 characters), limit (1–20)
/api/v1/search?q=tesla&limit=8API key required

Market rankings

Rank manufacturers by registrations, share or year-on-year change.

metric=registrations|share|yoy, limit (1–100)
/api/v1/rankings?metric=share&limit=25API key required

Manufacturer detail

One manufacturer's registrations and market share.

brand path
/api/v1/brands/teslaAPI key required

Registration model detail

One registration model and its market context.

brand and model path
/api/v1/models/tesla/model-3API key required

Territory detail

Territory registrations, manufacturer distribution and location quotients.

region path
/api/v1/regions/attikiAPI key required

Manufacturer model history

Historical registrations by manufacturer and model.

brand path
/api/v1/analytics/manufacturer-models/teslaAPI key required

Market and EV briefing

A decision-ready synthesis of market momentum, EV adoption, competition and public charging coverage.

No parameters
/api/v1/briefingAPI key required

Data health

Latest periods, source coverage and explicit gates for metrics still collecting or awaiting an official source.

No parameters
/api/v1/healthAPI key required

Registration time series

National, manufacturer or territory history with matching previous-year values.

from, to, category=pc|lcv, brand, territory
/api/v1/registrations?from=2025-01&to=2026-08&category=pcAPI key required

Manufacturer rankings

Current-period or annual manufacturer rows and the comparable market total.

period, year, category=pc|lcv, q, limit
/api/v1/brands?period=2026-08&category=pc&limit=25API key required

All-fuel model rankings

Official passenger-car model and segment rows for the latest matched segment release.

brand, segment, q, limit
/api/v1/models?segment=B-SUV&limit=25API key required

Electric market

Latest and monthly BEV/PHEV totals plus validated annual context.

No parameters
/api/v1/electricAPI key required

Complete fuel mix

Official monthly and YTD petrol, diesel, HEV, PHEV, BEV and LPG shares with source-family reconciliation.

No parameters
/api/v1/fuel-mixAPI key required

Electric models

Official BEV and PHEV brand/model rows where matching segment sources are imported.

No parameters; filter the returned rows by their official powertrain field
/api/v1/electric/modelsAPI key required

EV Decision Centre catalogue

Registration context, reviewed identity aliases, variants, normalized specifications and field-level manufacturer sources.

powertrain=BEV|PHEV, q, verified=true|false, limit
/api/v1/ev-models?verified=true&limit=25API key required

EV model detail

One EV identity with availability, variant observations, explicit nulls and source freshness.

brand and model path; optional powertrain=BEV|PHEV
/api/v1/ev-models/tesla/model-3?powertrain=BEVAPI key required

Territory distribution

Official territory registrations and national shares for the latest matched report.

category=pc|lcv
/api/v1/regions?category=pcAPI key required

Public charging network

MYFAH snapshot, growth, dated NUTS-2 coverage benchmark, operators and bounded location records.

operator, min_power_kw, status=all|available|charging|unavailable, limit
/api/v1/chargers?min_power_kw=50&limit=100API key required

Data coverage

Coverage varies by dataset and reporting period. Missing data is identified explicitly; a published zero is kept distinct from an unavailable value. Passenger-car and light commercial vehicle figures are reported separately. Include the source and reporting period when citing or reusing results.