API Documentation

Integrate Brussels transport data into your applications with our robust and reliable API.

Endpoints

GET/api/v1/gtfs/realtime

Real-time Vehicle Positions

Get live positions of all vehicles currently operating on the network.

Example Response

{
  "header": {
    "gtfs_realtime_version": "2.0",
    "incrementality": "FULL_DATASET",
    "timestamp": "1716987452"
  },
  "entity": [
    {
      "id": "vehicle_8201",
      "vehicle": {
        "trip": {
          "trip_id": "1145829302",
          "start_time": "14:30:00",
          "start_date": "20240529",
          "route_id": "1"
        },
        "position": {
          "latitude": 50.8467,
          "longitude": 4.3528,
          "bearing": 120.5,
          "speed": 35.2
        },
        "current_stop_sequence": 12,
        "current_status": "IN_TRANSIT_TO",
        "timestamp": "1716987450",
        "vehicle": {
          "id": "8201",
          "label": "Metro 1 - Gare de l'Ouest"
        }
      }
    },
    {
      "id": "vehicle_9052",
      "vehicle": {
        "trip": {
          "trip_id": "1145829445",
          "start_time": "14:35:00",
          "start_date": "20240529",
          "route_id": "5"
        },
        "position": {
          "latitude": 50.8359,
          "longitude": 4.3892,
          "bearing": 270,
          "speed": 0
        },
        "current_stop_sequence": 5,
        "current_status": "STOPPED_AT",
        "timestamp": "1716987451",
        "vehicle": {
          "id": "9052",
          "label": "Metro 5 - Erasme"
        }
      }
    }
  ]
}

GET/api/v1/network/lines

Network Lines

Retrieve a list of all active lines in the STIB-MIVB network.

Example Response

{
  "data": [
    {
      "id": "1",
      "short_name": "1",
      "long_name": "GARE DE L'OUEST - STOCKEL",
      "mode": "metro",
      "color": "#C4008F",
      "text_color": "#FFFFFF"
    },
    {
      "id": "2",
      "short_name": "2",
      "long_name": "SIMONIS - ELISABETH",
      "mode": "metro",
      "color": "#F57000",
      "text_color": "#FFFFFF"
    },
    {
      "id": "81",
      "short_name": "81",
      "long_name": "MARIUS RENARD - MONTGOMERY",
      "mode": "tram",
      "color": "#76C043",
      "text_color": "#FFFFFF"
    },
    {
      "id": "95",
      "short_name": "95",
      "long_name": "GRAND-PLACE - WIENER",
      "mode": "bus",
      "color": "#888888",
      "text_color": "#FFFFFF"
    }
  ],
  "meta": {
    "total_count": 84,
    "page": 1,
    "per_page": 20
  }
}

GET/api/v1/network/stops/{stop_id}

Stop Details

Get detailed information about a specific stop, including location and wheelchair accessibility.

Example Response

{
  "data": {
    "id": "8022",
    "code": "8022",
    "name": "DE BROUCKERE",
    "location": {
      "lat": 50.8502,
      "lon": 4.3525
    },
    "zone_id": "1",
    "wheelchair_boarding": 1,
    "lines": [
      "1",
      "5",
      "29",
      "66",
      "71"
    ],
    "features": {
      "escalator": true,
      "elevator": true,
      "ticket_machine": true
    }
  }
}

Authentication

All API requests require an API key to be included in the header. You can obtain an API key by signing up for a Pro or Enterprise plan.

Authorization: Bearer YOUR_API_KEY