GET/v1/departuresRequiere X-API-Key

Próximas salidas

Salidas ordenadas por hora desde una estación, para un día concreto.

Parámetros

Nombre	En	Tipo	Requerido	Descripción
from	query	string	requerido	stop_id de origen.
date	query	string	opcional	DD-MM-YYYY (o ISO YYYY-MM-DD). Por defecto, hoy.
limit	query	integer	opcional	Número máximo de salidas. Por defecto, 50.

Ejemplo

Request

curl "https://api.bonovia.app/v1/departures?from=18000&limit=10" \
  -H "X-API-Key: tu_key_aqui"

Response

{
  "station_id": "18000",
  "date": "2026-09-24",
  "departures": [
    { "trip_id": "...", "departure_time": "06:56", "route_short_name": "MD", "mode": "train" }
  ],
  "count": 1
}

Una estación sin datos precomputados devuelve un array vacío con 200, no un error.

Errores posibles de este endpoint

400

Falta el parámetro from.

{ "error": "Missing 'from' station ID" }

400

El parámetro date no tiene un formato válido.

{ "error": "Invalid date format. Use YYYY-MM-DD" }

401

Falta la cabecera X-API-Key, o la key no es válida, ha sido revocada, o ha expirado.

{ "error": "Missing or invalid X-API-Key" }

429

Superaste el límite de peticiones (60/min por key, o el respaldo por IP).

{ "error": "Too many requests" }

Formato general de errores →