{"openapi":"3.1.0","info":{"title":"En retard, chef — Paris metro, RER, tram & bus live API","version":"1.0.0","description":"Free public API for live public transport information in Paris and Île-de-France: traffic status of every metro, RER, Transilien, tram and bus line, real-time next departures, journeys and scheduled timetables. No key needed. Data: Île-de-France Mobilités (ODbL) — please credit \"En retard, chef (enretardchef.fr)\" and link to the `url` of each answer. Also available as an MCP server: https://enretardchef.fr/mcp","contact":{"name":"En retard, chef","url":"https://enretardchef.fr/api-metro-paris","email":"contact@enretardchef.fr"},"license":{"name":"ODbL-1.0","url":"https://opendatacommons.org/licenses/odbl/1-0/"}},"servers":[{"url":"https://enretardchef.fr"}],"externalDocs":{"url":"https://enretardchef.fr/api-metro-paris"},"paths":{"/api/v1/traffic":{"get":{"operationId":"getTrafficStatus","summary":"Live traffic status","description":"Live traffic status (official Île-de-France Mobilités messages): disrupted or normal, reason, expected end, planned works. Without line: all metro, RER, Transilien and tram lines. A bus line also works (\"bus 70\").","parameters":[{"name":"line","in":"query","required":false,"description":"Rail line: metro 1-14, 3bis, 7bis; RER A-E (\"RER B\"); Transilien H, J, K, L, N, P, R, U, V; tram T1-T14 (\"T3a\"); CDGVAL, Orlyval. Or a bus line (\"bus 70\"). Omit for all rail lines.","schema":{"type":"string","maxLength":40}},{"name":"lang","in":"query","required":false,"description":"Language of names and official traffic messages: fr (default) or en.","schema":{"type":"string","enum":["fr","en"]}}],"responses":{"200":{"description":"Traffic status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v1/departures":{"get":{"operationId":"getNextDepartures","summary":"Real-time next departures at a station","description":"Real-time next metro / RER / Transilien / tram departures at a station, per line and destination (minutes), with each line's traffic. Without line: all lines of the station. At night: next scheduled departures.","parameters":[{"name":"station","in":"query","required":true,"description":"Station name (\"Châtelet\", \"Gare du Nord\") or id from /api/v1/stations.","schema":{"type":"string","maxLength":80}},{"name":"line","in":"query","required":false,"description":"Rail line: metro 1-14, 3bis, 7bis; RER A-E (\"RER B\"); Transilien H, J, K, L, N, P, R, U, V; tram T1-T14 (\"T3a\"); CDGVAL, Orlyval. Optional.","schema":{"type":"string","maxLength":40}},{"name":"lang","in":"query","required":false,"description":"Language of names and official traffic messages: fr (default) or en.","schema":{"type":"string","enum":["fr","en"]}}],"responses":{"200":{"description":"Next departures","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v1/journey":{"get":{"operationId":"planJourney","summary":"Journey between two stations","description":"Journey by metro, RER, Transilien and tram between two stations: estimated duration, legs (line, direction, board/alight, stops), transfers, and lines of the journey disrupted now.","parameters":[{"name":"from","in":"query","required":true,"description":"Departure station (name or id).","schema":{"type":"string","maxLength":80}},{"name":"to","in":"query","required":true,"description":"Arrival station (name or id).","schema":{"type":"string","maxLength":80}},{"name":"lang","in":"query","required":false,"description":"Language of names and official traffic messages: fr (default) or en.","schema":{"type":"string","enum":["fr","en"]}}],"responses":{"200":{"description":"Journey","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v1/timetable":{"get":{"operationId":"getTimetable","summary":"Scheduled timetable at a station","description":"Scheduled departures (official timetables, planned works included, no real time): next departures after a time, first and last train of the day, per destination. With to: direct trains to that station only.","parameters":[{"name":"station","in":"query","required":true,"description":"Station name or id.","schema":{"type":"string","maxLength":80}},{"name":"line","in":"query","required":false,"description":"Rail line: metro 1-14, 3bis, 7bis; RER A-E (\"RER B\"); Transilien H, J, K, L, N, P, R, U, V; tram T1-T14 (\"T3a\"); CDGVAL, Orlyval. Optional (default: all lines of the station).","schema":{"type":"string","maxLength":40}},{"name":"to","in":"query","required":false,"description":"Arrival station served without change.","schema":{"type":"string","maxLength":80}},{"name":"date","in":"query","required":false,"description":"Day YYYY-MM-DD (default: today in Paris).","schema":{"type":"string","format":"date"}},{"name":"after","in":"query","required":false,"description":"Time HH:MM (default: now).","schema":{"type":"string","pattern":"^\\d{1,2}[:h]\\d{2}$"}},{"name":"lang","in":"query","required":false,"description":"Language of names and official traffic messages: fr (default) or en.","schema":{"type":"string","enum":["fr","en"]}}],"responses":{"200":{"description":"Timetable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v1/stations":{"get":{"operationId":"findStations","summary":"Find stations by name or position","description":"Metro / RER / Transilien / tram stations by name (typos tolerated) or near a position (lat & lon): id, name, lines, town, coordinates, page URL.","parameters":[{"name":"q","in":"query","required":false,"description":"Station name.","schema":{"type":"string","maxLength":80}},{"name":"lat","in":"query","required":false,"description":"Latitude (with lon).","schema":{"type":"number"}},{"name":"lon","in":"query","required":false,"description":"Longitude (with lat).","schema":{"type":"number"}},{"name":"lang","in":"query","required":false,"description":"Language of names and official traffic messages: fr (default) or en.","schema":{"type":"string","enum":["fr","en"]}}],"responses":{"200":{"description":"Stations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v1/bus/stops":{"get":{"operationId":"findBusStops","summary":"Find bus stops","description":"Bus stops anywhere in Île-de-France (all networks, Noctilien included) by name, optionally on a line: id, name, town, coordinates, lines.","parameters":[{"name":"q","in":"query","required":true,"description":"Bus stop name.","schema":{"type":"string","maxLength":80}},{"name":"line","in":"query","required":false,"description":"Bus line, e.g. \"70\", \"N01\".","schema":{"type":"string","maxLength":40}},{"name":"lang","in":"query","required":false,"description":"Language of names and official traffic messages: fr (default) or en.","schema":{"type":"string","enum":["fr","en"]}}],"responses":{"200":{"description":"Bus stops","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/v1/bus/departures":{"get":{"operationId":"getBusDepartures","summary":"Real-time next buses at a stop","description":"Real-time next buses at a stop (minutes), all lines or one line, with that line's traffic status. stop: id from findBusStops (more precise) or a name.","parameters":[{"name":"stop","in":"query","required":true,"description":"Bus stop id or name.","schema":{"type":"string","maxLength":80}},{"name":"line","in":"query","required":false,"description":"Bus line, e.g. \"70\".","schema":{"type":"string","maxLength":40}},{"name":"lang","in":"query","required":false,"description":"Language of names and official traffic messages: fr (default) or en.","schema":{"type":"string","enum":["fr","en"]}}],"responses":{"200":{"description":"Next buses","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}}},"components":{"schemas":{"Result":{"type":"object","description":"Answer. `url` = page on enretardchef.fr to follow it live; `source` = attribution to display.","properties":{"url":{"type":"string"},"source":{"type":"string"}},"additionalProperties":true},"Error":{"type":"object","properties":{"error":{"type":"string"},"suggestions":{"type":"array","items":{"type":"object"}}},"additionalProperties":true}},"responses":{"Error":{"description":"Error (invalid parameter, not found, rate limited) with suggestions when available.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}