An async and sync wrapper for the MVG endpoints, with data validation through pydantic.

• Fully ™️ complete: There is a wrapper for all endpoints known and/or currently used by the mvg.de homepage as of early 2026 in the mvg_api.v3 interface. See the functions section for the available endpoints.
• Sync and async support: You can use this wrapper to make API calls synchronously or asynchronously based on your needs. It provides flexibility and allows you to leverage the benefits of both approaches.
• Pydantic schema validation: The wrapper integrates with pydantic, a powerful data validation and parsing library, to validate API responses against predefined schemas. This ensures that the received data conforms to the expected structure and types. For every API endpoint, there is a corresponding pydantic schema that defines the expected structure of the response. If the response does not match the schema, an exception is raised.
• Documented schemas: All schemas are documented with the known (or assumed) result type and content to that you know what data you can expect.
• Common line representation: The api itself is not very consistent in attribute naming, especially with lines/services. To simplify handling and displayal of lines the helper class NetworkLine provides unified access to the lines returned by the departure, connection, aushang, ... endpoints. The helper can also provides color codes for the individual lines.

Install it over pip or from source by cloning the repository and installing the dependencies with uv.

pip install async-mvg-api

or

git clone https://github.com/Plutokekz/MVG-Api.git
cd MVG-Api
uv sync

from mvg_api.v3 import SyncMVG

# load station information of 'Sendlinger Tor'
station_info = SyncMVG().get_station("de:09162:50")
print(station_info)

# load departures at 'Sendlinger Tor'
departures = SyncMVG().get_departures("de:09162:50")
print(departures)

The station info will yield:

{
  "name": "Sendlinger Tor",
  "place": "München",
  "id": "de:09162:50",
  "divaId": 50,
  "abbreviation": "SE",
  "tariffZones": "m",
  "products": [
    "UBAHN",
    "TRAM",
    "BUS"
  ],
  "latitude": 48.133444,
  "longitude": 11.566681
}

See the list of functions below for the other available endpoints.

All functions and schemas are documented.

There is quite some development in the api by mvg.de, leading to semi-frequent breaking changes or new attributes that are available. The latest breaking change was from fib/v2 to bgw-pt/v3 in October of 2024.

If a response does not match the pydantic schema, an exception is raised. If that is the case, you can hotfix the schema directly. In most cases that will be a required attribute that is no longer returned by the api. Please also file an issue on this repository such that it can be fixed soon in the library.

There are multiple different identifiers used for stations in the MVV and MVG areas

IFOPT stop ids are in the format country:admin_area:stop_place[:level:quay] (aka country:region:station[:stopgroup:stoppoint]).

Stop points of a station have a more detailed IFOPT id with the suffix :stopgroup:stoppoint. For ubahn services, the stopgroup identifies the Bahnsteig (e.g. only one at Universität, but two at Innsbrucker Ring) and the stopoint identifies the track and is typically offset by 50 (e.g. track 1 is :51).

Among others, there is also a diva id to identify lines (not to be confused with the station diva id):
Encountered '92M07' for S7, '92M01' for S1, '010U6' for U6, '' for fussweg

uv run pytest mvg_api/v1/tests/api_tests.py mvg_api/v2/tests/api_tests.py mvg_api/v3/tests/api_tests.py

For Endpoint Information and Code snippets

• https://github.com/leftshift/python_mvg_api
• https://www.mvg.de/

ACHTUNG:

Unsere Systeme dienen der direkten Kundeninteraktion. Die Verarbeitung unserer Inhalte oder Daten durch Dritte erfordert unsere ausdrückliche Zustimmung. Für private, nicht-kommerzielle Zwecke, wird eine gemäßigte Nutzung ohne unsere ausdrückliche Zustimmung geduldet. Jegliche Form von Data-Mining stellt keine gemäßigte Nutzung dar. Wir behalten uns vor, die Duldung grundsätzlich oder in Einzelfällen zu widerrufen. Fragen richten Sie bitte gerne an: [email protected].

In other words: Private, noncommercial, moderate use of the API is tolerated. They do not consider data mining as a moderate use.

(Disclaimer: I am not a lawyer, this is not legal advice)