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!
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
- Lisbon transit app showing real-time metro line status
- Commute alert system that notifies of line disruptions
- Tourist guide with metro station information and nearby attractions
- Journey planner checking which lines are affected before routing
- City dashboard monitoring Lisbon's public transport health