Find nearby public transport stations
Multi-provider transit discovery. ROOTE automatically queries configured complementary aggregators in parallel, then normalizes and conservatively resolves their identities. Realtime departures and alerts are intentionally not fetched by this endpoint. Strict DTO by default; legacy requires public_contract=legacy. See /docs/PUBLIC_API_MIGRATION.md. entity_level=station selects the experimental persisted projection, overriding the DTO selector. providers, realtime and language are accepted but not executed on this branch; no provider acquisition occurs. Coverage stays partial even for an empty registry result. Explicit public_contract=roote-1.1.0 selects the freeze-ready whitelist and qualified EMPTY semantics; existing default/version/legacy responses remain compatible. Unknown source freshness does not establish operational availability. Internal acquisition/matching metadata is excluded from the freeze-ready projection. Generic acquisition returns typed entities and Line dictionaries; entity_level=station is the separate persisted canonical Station marker projection. Empty persisted inventory is partial, never a qualified absence.
Request
- Base URL: https://api.roote.ai
- URL: https://api.roote.ai/v1/transit/nearby
- Auth: one of:
- none
- HTTP bearer
Query parameters
Latitude of query_origin
Longitude; supply lng or lon.
ROOTE compatibility alias for lng.
Requested metres; values above 5000 are clamped to 5000 Larger positive requests are accepted and clamped (radius 5000m, limit at most 200 and capability policy).
Maximum returned stations; capability policy can apply a lower limit Larger positive requests are accepted and clamped (radius 5000m, limit at most 200 and capability policy).
Comma-separated canonical ROOTE transit modes
Optional diagnostic override. Normal clients should omit it so ROOTE can select configured providers automatically.
Reserved preference; Nearby reports capabilities without fetching departures or alerts.
Preferred response language for providers that support it.
Include provider and cache diagnostics
Compatibility API token; prefer Authorization Bearer.
Omit for strict DTO. Version remains an explicit alias. legacy is deprecated; no silent fallback.
Opt-in station-stop-point-v1: persisted Station markers only, provider_calls=0, partial coverage; existing acquisition is unchanged when omitted.
Response
Strict public DTO (default and explicit version alias).
Changes
No recorded changes to this operation across all 1 revision of this API.