Carris Metropolitana API

Base URL

https://api.carrismetropolitana.pt

Authentication

No key or account. Open data published by the operator for the Lisbon metropolitan transport authority.

Rate limit

No published quota. Real-time endpoints refresh every few seconds; static data changes only with timetable revisions.

Pricing

Free.

CORS

Enabled — callable directly from browser JavaScript

Official docs

Read the docs

Every request below was executed against the live API on 21 Aug 2026, and the response shown is the real body it returned — not an illustration.

curl 'https://api.carrismetropolitana.pt/lines/1001'

const res = await fetch("https://api.carrismetropolitana.pt/lines/1001");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get("https://api.carrismetropolitana.pt/lines/1001", timeout=20)
res.raise_for_status()
print(res.json())

{
  "color": "#C61D23",
  "facilities": [],
  "id": "1001",
  "localities": [
    "Alfragide",
    "Amadora",
    "Reboleira",
    "Buraca"
  ],
  "long_name": "Alfragide (Estr Seminario) - Reboleira (Estação)",
  "municipalities": [
    "1115"
  ],
  "patterns": [
    "1001_0_1",
    "1001_0_2"
  ],
  "routes": [
    "1001_0"
  ],
  "short_name": "1001",
  "text_color": "#FFFFFF"
}

idstring

Line identifier, such as "1001". It appears again as a prefix in route and pattern ids.

short_name / long_namestring

The number shown on the vehicle and the full route description with its endpoints.

color / text_colorstring

Official hex colours including the leading hash, so a rendered badge matches printed material.

localitiesarray

Named places the line serves, which is more useful for search than the municipality codes.

municipalitiesarray

Municipality codes the line passes through, for administrative filtering.

routesarray

Route ids belonging to this line — normally one per direction.

patternsarray

Pattern ids, one per distinct stop sequence. Variants that skip a section appear here rather than as separate lines.

facilitiesarray

Accessibility and interchange facilities associated with the line, often empty.

• Build a Lisbon-area bus route browser
• Show live arrival estimates at a specific stop
• Plot live vehicle positions on a map
• Render line badges in the operator's official colours
• Filter routes by municipality or locality for a local guide

If Carris Metropolitana does not fit, these transport & vehicle apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.