GET/v1/exploreRequiere X-API-Key

Explorar destinos alcanzables

Todos los destinos alcanzables desde una estación de origen, en trayecto directo, con duración y operador. Paginado.

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.
maxTime	query	integer	opcional	Duración máxima del trayecto en minutos. Por defecto, 360.
page	query	integer	opcional	Página, 1-indexada. Por defecto, 1.
perPage	query	integer	opcional	Destinos por página. Por defecto, 200. Máximo, 500.

Ejemplo

Request

curl "https://api.bonovia.app/v1/explore?from=cluster_madrid&date=24-09-2026&maxTime=180&page=1" \
  -H "X-API-Key: tu_key_aqui"

Response

{
  "origin": "cluster_madrid",
  "origin_lat": 40.449,
  "origin_lon": -3.643,
  "date": "2026-09-24",
  "max_time_minutes": 180,
  "destinations": [
    { "stop_id": "...", "stop_name": "...", "duration_minutes": 45, "mode": "train" }
  ],
  "count": 200,
  "page": 1,
  "per_page": 200,
  "total": 743,
  "total_pages": 4,
  "precomputed": true
}

Solo trayectos directos — no incluye combinaciones con transbordo.

Un origen con muchos destinos (p. ej. Madrid) no cabe en una sola respuesta — usa page/total_pages para recorrerlos todos.

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 DD-MM-YYYY" }

400

La fecha pedida es anterior a hoy.

{ "error": "La fecha no puede ser anterior a hoy.", "destinations": [] }

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 →