Metro Lisboa

Transportation API · Lisbon, Portugal · Metro status and alerts

How to Use This API

1. Network Status (All Lines)

https://api.metrolisboa.pt/status

2. Status for Specific Line

https://api.metrolisboa.pt/status/linha/azul

3. Station Information

https://api.metrolisboa.pt/estacao/Alameda

4. Service Alerts

https://api.metrolisboa.pt/alertas

5. JavaScript — Line Check

async function metroStatus() {
  const resp = await fetch('https://api.metrolisboa.pt/status');
  const lines = await resp.json();
  
  console.log('Lisbon Metro Status:');
  lines.forEach(line => {
    const status = line.estado === 'Normal'
      ? '\u2705' : '\u26A0\uFE0F';
    console.log(`${status} ${line.nome}: ${line.estado}`);
    if (line.observacoes) {
      console.log(`   ${line.observacoes}`);
    }
  });
}

metroStatus();

6. Python — Alert Monitor

import requests

def check_alerts():
    try:
        resp = requests.get('https://api.metrolisboa.pt/alertas')
        alerts = resp.json()
        
        if not alerts:
            print('No active alerts — all lines running normally')
            return
        
        print('Metro Lisboa Active Alerts:')
        for alert in alerts:
            print(f'  \u26A0\uFE0F {alert.get("titulo", "Alert")}')
            print(f'    {alert.get("descricao", "")[:100]}')
            print(f'    Updated: {alert.get("data", "N/A")}')
            
    except Exception as e:
        print(f'Could not fetch alerts: {e}')

check_alerts()

TL;DR

Metro Lisboa API provides real-time status of the Lisbon Metro system — all four lines (Azul, Amarela, Verde, Vermelha) with current operating status, service alerts, and maintenance notices. Check if each line is running normally, experiencing delays, or has planned maintenance. Station information includes location, zone, and nearby points of interest. Essential for building Lisbon transit apps, commute planners, and travel guides for Portugal's capital city. Official API provided by Metropolitano de Lisboa, completely free and open.

Quick start: https://api.metrolisboa.pt/status

No API key needed — just make a request!

Current metro status: https://api.metrolisboa.pt/status

Frequently Asked Questions

What lines are covered?
All four Lisbon Metro lines: Azul (Blue/Seagull), Amarela (Yellow/Sunflower), Verde (Green/Caravel), and Vermelha (Red/Oriente). The API also covers the Oriente-Aeroporto connection.
Do I need an API key?
No. This is an official public API from Metropolitano de Lisboa with no authentication required.
What data is returned per line?
Line name (Portuguese), current status (Normal, Interrompida, etc.), observations/notes, and last update timestamp.
How often is status updated?
Real-time. The API reflects the current operational status as updated by Metro Lisboa's control center.
Can I get station schedules?
The status API focuses on real-time line conditions. Schedule and timetable data may be available through the station information endpoint.
Is the API available in English?
The API primarily uses Portuguese, but the status values are straightforward (Normal = Normal, Interrompida = Interrupted, etc.).

API Details

API URL
https://api.metrolisboa.pt/
Documentation
metrolisboa.pt
Category
Transportation
Authentication
Not Required
Geographic Coverage
Lisbon, Portugal

What You Can Build