API Documentacion

API REST para consultar informacion del transporte publico de Santiago. Base URL: https://tpte.illanes00.cl/api/v1

Documentacion interactiva (Swagger UI) disponible en: /docs

🚏Paraderos(6)

GET/api/v1/stops/{stop_code}/arrivals

Obtiene las proximas llegadas de buses a un paradero en tiempo real.

curl https://tpte.illanes00.cl/api/v1/stops/PA1/arrivals

Probar en vivo

GET/api/v1/stops/{stop_code}

Obtiene informacion detallada de un paradero: nombre, ubicacion, recorridos.

curl https://tpte.illanes00.cl/api/v1/stops/PA1

Probar en vivo

GET/api/v1/stops/{stop_code}/services

Lista los recorridos que pasan por un paradero.

curl https://tpte.illanes00.cl/api/v1/stops/PA1/services

Probar en vivo

GET/api/v1/stops/nearby/search?lat={lat}&lon={lon}

Busca paraderos cercanos a una coordenada geografica.

curl "https://tpte.illanes00.cl/api/v1/stops/nearby/search?lat=-33.4489&lon=-70.6693"

Probar en vivo

GET/api/v1/gtfs/stops?q={query}&page={page}&per_page={per_page}

Busca paraderos GTFS por nombre o codigo con paginacion.

curl "https://tpte.illanes00.cl/api/v1/gtfs/stops?q=mapocho&per_page=10"

Probar en vivo

GET/api/v1/gtfs/stops/all

Retorna todos los paraderos con campos minimos (para renderizar mapa).

curl https://tpte.illanes00.cl/api/v1/gtfs/stops/all

Probar en vivo

🚍Recorridos(5)

GET/api/v1/routes

Lista todos los recorridos disponibles.

curl https://tpte.illanes00.cl/api/v1/routes

Probar en vivo

GET/api/v1/routes/{route_code}

Obtiene informacion detallada de un recorrido: paradas, trazado, frecuencias.

curl https://tpte.illanes00.cl/api/v1/routes/506

Probar en vivo

GET/api/v1/gtfs/routes?page={page}&per_page={per_page}

Lista rutas GTFS con paginacion.

curl https://tpte.illanes00.cl/api/v1/gtfs/routes

Probar en vivo

GET/api/v1/gtfs/shapes/{shape_id}

Obtiene los puntos del trazado de una ruta (shape points).

curl https://tpte.illanes00.cl/api/v1/gtfs/shapes/506I

Probar en vivo

GET/api/v1/gtfs/routes/all

Retorna todas las rutas (~427) con shapes simplificados para renderizar mapa de transito. Incluye color GTFS real de cada ruta.

curl https://tpte.illanes00.cl/api/v1/gtfs/routes/all

Probar en vivo

🚀Buses(1)

GET/api/v1/buses/positions

Snapshot en tiempo real de buses geolocalizados. Incluye servicio original del feed, resolucion de T-prefix, heading inferido por movimiento y bloques de tail para renderizar el badge.

curl https://tpte.illanes00.cl/api/v1/buses/positions

Probar en vivo

⚙️Sistema(2)

GET/api/v1/health

Health check del servicio.

curl https://tpte.illanes00.cl/api/v1/health

Probar en vivo

GET/api/v1/gtfs/versions

Metadata sobre las fuentes de datos GTFS/DTPM cargadas.

curl https://tpte.illanes00.cl/api/v1/gtfs/versions

Probar en vivo

Formato de respuesta

Ejemplo de respuesta de buses (/buses/positions):

[
  {
    "plate": "PGPS-97",
    "raw_service": "T1406",
    "service": "106",
    "resolved_service": "106",
    "resolution_source": "t_code",
    "resolution_confidence": 1,
    "service_observed_at": "2026-03-11T19:33:59Z",
    "color": "AF2B1E",
    "lat": -33.52161,
    "lon": -70.80263,
    "speed": 0,
    "direction": "Regreso",
    "heading": null,
    "moving": false,
    "tail_blocks": 0
  },
  {
    "plate": "PGPT-42",
    "raw_service": "T1423",
    "service": "T1423",
    "resolved_service": null,
    "resolution_source": "unresolved",
    "resolution_confidence": null,
    "service_observed_at": null,
    "color": "555555",
    "lat": -33.52157,
    "lon": -70.80175,
    "speed": 0,
    "direction": "Regreso",
    "heading": null,
    "moving": false,
    "tail_blocks": 0
  }
]