Skip to content
mavrovde edited this page Nov 1, 2026 · 6 revisions

ViaFrei API

viafrei-api is the planned public, RESTful, keyed and read-only HTTP API to ViaFrei's live German mobility data. ViaFrei describes itself as The German Real-Time Mobility Context Platform for AI: it brings motorway traffic, roadworks, fuel prices, EV charging, parking, public-transport departures and disruptions, station accessibility, weather warnings and places into one consistent, Germany-wide picture.

ViaFrei already serves that picture to AI assistants through its MCP server (see viafrei.de). The API is the second door to the same data: a conventional, documented REST interface for developers, applications and businesses that want structured answers instead of a conversation.

Status: design phase. Nothing is implemented yet. The architecture, principles and endpoint plan on these pages are published before the code, so anyone can see what we intend to build and hold us to it. The implementation language is still open: Go and Rust are the preferred candidates and TypeScript is compared in full as the third; a benchmark decides. See Project Status.

What the API will offer

Domain Typical question the API answers
Road conditions How is the A8 between Munich and Stuttgart right now? What roadworks are ahead of me?
Energy stops Where can I refuel or charge near a place or along my route?
Parking Where can I park a car or a lorry near X or along the route?
Public transport What are the next departures at a station, and what is disrupted there?
Accessibility Are the lifts and escalators at this station working?
Weather risk Are there official weather warnings at a place or along a route?
Places Where is X, and what is around it?
Driving rules What are the curated rules for, for example, lorries on Sundays?

Every answer names the publisher and licence of the data it contains. See Principles.

Start here

How to follow and take part

The repository is public and developed in the open: pull requests, CI, security scanning and releases are all visible. See Contributing for how to follow progress, report a problem or propose a change.

A note on wording

On these pages, design target means a goal the implementation must meet and that tests will check. Assumption marks something we believe but have not yet confirmed. Nothing on these pages is a measurement of a running ViaFrei API, because there is no running API yet.

Home

About

Design

Data Model

Technical specification

Testing

Engineering

Technology choice

Reference

Clone this wiki locally