Transport for Belgium SDKs & Libraries: Access Belgian Transport Data (2026)

SDKs overview

Transport for Belgium offers a suite of APIs designed to provide comprehensive access to public transport data across Belgium. These APIs include real-time departure and arrival information, journey planning capabilities, and static data for various operators such as iRail, De Lijn, NMBS/SNCB, and TEC. To streamline development and facilitate integration, official and community-contributed SDKs (Software Development Kits) are available. These SDKs abstract much of the underlying HTTP request handling and JSON parsing, allowing developers to interact with the APIs using idiomatic language constructs.

The primary purpose of these SDKs is to reduce the boilerplate code required to connect to the Transport for Belgium APIs, enabling developers to focus on application logic rather than low-level API communication. SDKs typically handle authentication, request formatting, response parsing, and error handling, which are common tasks when working with RESTful web services. The availability of SDKs in multiple programming languages supports a broad range of development environments and preferences, promoting wider adoption and integration of Belgian transport data into various applications.

Developers can find detailed information regarding the API endpoints and data models in the Transport for Belgium API documentation. This documentation serves as the foundational reference for understanding the data structures and operational specifics that the SDKs abstract.

Official SDKs by language

Transport for Belgium maintains official SDKs for key programming languages, ensuring direct support and compatibility with their API ecosystem. These SDKs are developed and maintained by the Transport for Belgium team or closely affiliated contributors, providing reliable interfaces for accessing transport data. The official SDKs are designed to follow best practices for each respective language, offering a consistent and efficient developer experience. Below is a table detailing the officially supported SDKs:

Each official SDK provides specific methods corresponding to the available API endpoints, such as fetching departures, arrivals, or planning a route between two locations. Developers are encouraged to refer to the official Transport for Belgium documentation for up-to-date installation instructions, method signatures, and usage examples specific to each SDK.

Installation

Installation of the Transport for Belgium SDKs typically involves using standard package managers for each programming language. This ensures that dependencies are correctly resolved and the SDK can be easily integrated into existing projects. The following examples illustrate the common installation procedures for the officially supported SDKs:

Python SDK

The Python SDK can be installed using pip, the Python package installer. It is recommended to install it within a virtual environment to manage project dependencies effectively.

python3 -m venv venv
source venv/bin/activate
pip install transport-be-python

JavaScript (Node.js) SDK

For Node.js projects, the SDK is available via npm, the Node.js package manager. This command adds the SDK as a dependency to your project.

npm install @transport-be/js-sdk

Java SDK

Java projects typically use build automation tools like Maven or Gradle. The Transport for Belgium Java SDK can be added as a dependency in your pom.xml (for Maven) or build.gradle (for Gradle) file. Specific dependency snippets are provided in the Transport for Belgium Java SDK documentation.

For Maven, an example entry in pom.xml might look like:

<dependency>
    <groupId>be.transport</groupId>
    <artifactId>transport-be-java</artifactId>
    <version>1.0.0</version>
</dependency>

For Gradle, an example entry in build.gradle might look like:

implementation 'be.transport:transport-be-java:1.0.0'

Ensure to replace 1.0.0 with the latest stable version as indicated in the official documentation.

Quickstart example

This quickstart example demonstrates how to fetch real-time departure information for a specific station using the Python SDK. This illustrates a common use case for the Transport for Belgium APIs: accessing dynamic public transport data. Before running this code, ensure you have installed the Python SDK as described in the Installation section and have a valid API key, if required for your usage tier.

Python Quickstart: Get Departures

This example retrieves the next 5 departures from a hypothetical station identified by its iRail ID.

from transport_be_python.irail import iRailClient

# Initialize the iRail client
# API keys are generally not required for the free tier, but can be passed if needed.
client = iRailClient()

station_id = "8892007"  # Example: Brussels-Central station iRail ID

try:
    # Fetch next 5 departures from the station
    departures = client.get_departures(station_id=station_id, results_limit=5)

    if departures:
        print(f"Next 5 departures from {station_id}:")
        for departure in departures:
            print(f"  Train: {departure.vehicle} to {departure.direction} at {departure.time.strftime('%H:%M')}")
    else:
        print(f"No departures found for station {station_id}.")

except Exception as e:
    print(f"An error occurred: {e}")

For more detailed examples, including journey planning and accessing data from other operators like De Lijn or TEC, consult the Transport for Belgium Python SDK documentation. This documentation often includes more complex scenarios and error handling best practices, which are essential for robust application development. Understanding HTTP status codes and API error responses is also crucial for debugging and building resilient applications.

Community libraries

Beyond the official SDKs, the Transport for Belgium ecosystem benefits from a vibrant community that contributes libraries and tools. These community-driven projects often extend functionality, provide integrations with specific frameworks, or offer support for languages not officially covered. While not officially maintained by Transport for Belgium, these libraries can be valuable resources, though their stability and long-term support may vary.

Examples of community contributions might include:

• PHP Client Libraries: Developers have created lightweight PHP wrappers for the iRail API, facilitating integration into web applications built with frameworks like Laravel or Symfony.
• Ruby Gems: Community-maintained Ruby gems might exist, offering idiomatic Ruby interfaces for accessing transport data, often found on platforms like RubyGems.org.
• Mobile Development Wrappers: Some developers might have created specific wrappers for iOS (Swift/Objective-C) or Android (Kotlin/Java) to simplify the consumption of Transport for Belgium APIs in mobile applications.
• Data Visualization Tools: Projects that consume transport data and present it through interactive maps or dashboards, often built using JavaScript libraries like Leaflet or D3.js, can also be considered community contributions.

When considering a community library, it is advisable to:

• Check the project's activity and last update date.
• Review the documentation and examples provided by the library maintainers.
• Examine the issue tracker and community support channels to gauge responsiveness.
• Consult the official Transport for Belgium API terms of service to ensure compliance when using third-party libraries.

Community contributions are often shared on platforms like GitHub, where developers can find source code, contribute enhancements, and report issues. Searching for "Transport for Belgium API" or specific operator names like "iRail API client" on these platforms can reveal useful community projects.