DotBahn is a collection of unofficial .NET client packages for accessing Deutsche Bahn (DB) APIs. Query train schedules, station details, and facility status directly in your application. It also provides convenience features like timetable merging, fluent queries, and additional properties.
| API | Description |
|---|---|
| Stations (StaDa) | Station data including parking, accessibility, and opening hours. |
| Facilities (FaSta) | Real-time operational status of elevators and escalators at stations. |
| Timetables | Scheduled departures and arrivals with real-time delay and platform change information. |
Install the packages you need from NuGet or GitHub Packages:
dotnet add package DotBahn.Timetables
dotnet add package DotBahn.Stations
dotnet add package DotBahn.FacilitiesNote
All client packages depend on DotBahn.Common, which provides cross-cutting abstractions such as authorization, base client infrastructure, and shared models. It is installed automatically as a transitive dependency.
All packages integrate seamlessly with IServiceCollection. Each client comes with a default endpoint, override only for custom proxies:
// Register clients
services.AddDotBahnStations();
services.AddDotBahnTimetables();
services.AddDotBahnFacilities();
// Configure authorization (required for API access)
services.AddDotBahnAuthorization(opt => {
opt.ClientId = clientId;
opt.ApiKey = clientSecret;
});
...
// Optional: override default endpoints
services.AddDotBahnStations(opt => {
opt.BaseEndpoint = new Uri("https://custom-proxy.example.com/stada");
});Create client instances directly without dependency injection. Each client creates and owns its own HttpClient:
using var client = new StationClient(
new ClientOptions {
BaseEndpoint = new Uri("https://apis.deutschebahn.com/db-api-marketplace/apis/station-data/v2/")
},
new AuthorizationOptions {
ClientId = clientId,
ApiKey = clientSecret
});A Deutsche Bahn API key is required. Register and obtain your credentials at the DB API Marketplace.
Warning
These packages only consume the credentials you provide for API authentication. They do not create, register, or manage credentials on your behalf.
A terminal-based departure board for ICE trains at a given station. Displays train numbers, scheduled and actual departure times, platforms, destinations, and routes. Highlights delays and platform changes in real time. Refreshes automatically every 2 minutes.
dotnet run --project samples/DotBahn.Samples.IceMonitor -- <EVA> <your-client-id> <your-client-secret>
An interactive terminal application for exploring DB station details. Search by name and navigate results with arrow keys. Shows station category, identifiers (EVA/RIL100), address, coordinates, regional area, available services, and real-time elevator/escalator status.
dotnet run --project samples/DotBahn.Samples.StationBrowser -- <SearchName> <your-client-id> <your-client-secret>