Traffic

View API Documentation

The traffic component provides information about the traffic in Brussels. It uses Telraam data to provide the number of vehicles per hour per day for certain segments of the Brussels road network. Other endpoints provide the count of vehicles registered by the cameras present in the tunnels of Brussels, as well as real-time traffic events and incident codes.

Endpoints

Telraam

/traffic/telraam

GEOJSON APPLICATION/JSON

The Telraam data for Brussels

From

2024-08-21 14:59:39

2026-04-07 22:04:21

Records

155,970

import requests
import geopandas as gpd

url = "https://api.mobilitytwin.brussels/traffic/telraam"

data = requests.get(url, headers={
        'Authorization': 'Bearer [MY_API_KEY]'
}).json()

gdf = gpd.GeoDataFrame.from_features(data["features"])

# Analyze traffic composition per segment
for _, seg in gdf.head(5).iterrows():
    total = seg['car'] + seg['heavy'] + seg['bike'] + seg['pedestrian']
    if total > 0:
        print(f"Segment {seg['segment_id']}: {seg['car']} cars, {seg['bike']} bikes, "
              f"{seg['heavy']} heavy, v85={seg['v85']:.0f} km/h")

# Plot segments colored by speed
gdf.plot(figsize=(12, 10), column='v85', legend=True, linewidth=2, cmap='RdYlGn')

Tunnels

/traffic/tunnels

JSON APPLICATION/JSON

The realtime traffic data for the tunnels of Brussels

From

2024-08-21 14:55:38

2026-04-07 22:06:24

Records

801,101

import requests

url = "https://api.mobilitytwin.brussels/traffic/tunnels"

data = requests.get(url, headers={
        'Authorization': 'Bearer [MY_API_KEY]'
}).json()

# Show real-time traffic per tunnel device
for device_id, device_data in data['data'].items():
    results = device_data['results']
    # Get 15-minute aggregate
    r = results['15m']
    for lane, stats in r.items():
        print(f"{device_id} ({lane}): {stats['count']} vehicles, "
              f"speed={stats['speed']:.0f} km/h, occupancy={stats['occupancy']:.1%}")

Tunnel devices

/traffic/tunnel-devices

GEOJSON APPLICATION/JSON

The position of the traffic devices in the tunnels of Brussels

From

2024-08-22 06:00:01

2026-04-07 06:00:00

Records

491

import requests
import geopandas as gpd

url = "https://api.mobilitytwin.brussels/traffic/tunnel-devices"

data = requests.get(url, headers={
        'Authorization': 'Bearer [MY_API_KEY]'
}).json()

gdf = gpd.GeoDataFrame.from_features(data["features"])

# List all tunnel monitoring devices
for _, device in gdf.iterrows():
    print(f"{device['traverse_name']}: {device.get('description_fr', 'N/A')}")

# Plot device locations on a map
gdf.plot(figsize=(10, 8), color="orange", markersize=20)

Bike count

/traffic/bike-count

JSON APPLICATION/JSON

The bike count data for the different bike counters in Brussels

From

2024-08-21 14:55:38

2026-04-07 22:06:23

Records

801,330

import requests

url = "https://api.mobilitytwin.brussels/traffic/bike-count"

data = requests.get(url, headers={
        'Authorization': 'Bearer [MY_API_KEY]'
}).json()

# Show bike counts per counter (hourly, daily, yearly)
for counter_id, counter_data in data.items():
    hourly = counter_data.get('hour_cnt', 0)
    daily = counter_data.get('day_cnt', 0)
    yearly = counter_data.get('year_cnt', 0)
    print(f"{counter_id}: {hourly} this hour, {daily} today, {yearly} this year")

Bike counters

/traffic/bike-counters

GEOJSON APPLICATION/JSON

The position of the bike counters in Brussels

From

2024-08-22 06:00:00

2026-04-07 06:00:05

Records

491

import requests
import geopandas as gpd

url = "https://api.mobilitytwin.brussels/traffic/bike-counters"

data = requests.get(url, headers={
        'Authorization': 'Bearer [MY_API_KEY]'
}).json()

gdf = gpd.GeoDataFrame.from_features(data["features"])

# List all active bike counters with their location
active = gdf[gdf['active'] == True]
for _, counter in active.iterrows():
    print(f"{counter['device_name']}: {counter.get('road_fr', 'N/A')}")

# Plot counter locations
active.plot(figsize=(10, 8), color="green", markersize=30)

Bus speed

/traffic/bus-speed

JSON APPLICATION/JSON

The average speed of the vehicles of STIB/MIVB on a 20 seconds interval, per line, stop and direction.

From

2024-08-21 14:54:58

2026-04-07 22:06:15

Records

2,449,563

import requests
import pandas as pd

url = "https://api.mobilitytwin.brussels/traffic/bus-speed"

data = requests.get(url, headers={
        'Authorization': 'Bearer [MY_API_KEY]'
}).json()

df = pd.DataFrame(data)

# Average bus speed per line
speed_per_line = df.groupby('lineId')['speed'].mean().sort_values()
print("Average bus speed per line (km/h):")
print(speed_per_line)

# Find the slowest segments
slowest = df.nsmallest(5, 'speed')[['lineId', 'pointId', 'speed']]
print("\nSlowest bus segments:")
print(slowest)

Events

/traffic/events

GEOJSON APPLICATION/JSON

Real-time traffic events in the Brussels-Capital Region (roadworks, accidents, congestion, etc.).

From

2026-03-30 11:05:24

2026-04-07 22:04:22

Records

2,069

import requests
import geopandas as gpd

url = "https://api.mobilitytwin.brussels/traffic/events"

data = requests.get(url, headers={
        'Authorization': 'Bearer [MY_API_KEY]'
}).json()

gdf = gpd.GeoDataFrame.from_features(data["features"])

# Show active traffic events
active = gdf[gdf['is_active'] == True]
for _, event in active.head(10).iterrows():
    print(f"[{event['type_fr']}] {event['location_fr']} — {event['consequences_fr']}")

# Plot active events on a map
active.plot(figsize=(10, 8), color="red", markersize=15)

Tmc event codes

/traffic/tmc-event-codes

GEOJSON APPLICATION/JSON

TMC (Traffic Message Channel) event codes reference data used for classifying traffic events in Brussels.

No data currently available

import requests
import pandas as pd

url = "https://api.mobilitytwin.brussels/traffic/tmc-event-codes"

data = requests.get(url, headers={
        'Authorization': 'Bearer [MY_API_KEY]'
}).json()

# Build a lookup table of TMC event codes
codes = pd.DataFrame([f['properties'] for f in data['features']])
print("TMC Event Codes:")
print(codes[['datex_code', 'descr_en', 'datex2_class']].to_string(index=False))