Read a durable canonical transport station

Reads stable metadata from the canonical PostgreSQL registry without calling a provider or loading departures. Invalid or revoked credentials never fall back to anonymous access. Strict DTO by default; legacy requires public_contract=legacy. See /docs/PUBLIC_API_MIGRATION.md. Accepts station, stop_area, stop_point and platform ROOTE IDs, including aliases within the same canonical Station or StopPoint level. A parent queries established children, not an inferred exhaustive inventory. Response ID positions retain the requested ID for compatibility; X-ROOTE-Canonical-ID exposes the canonical target. Wrong ID type returns 400, unknown ID 404, ambiguous identity 409. consolidated=true selects the experimental station-stop-point-v1 projection, overriding the DTO selector. For an unparented StopPoint station.entity_level remains stop_point; it is not an inferred Station. 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.

get/v1/transit/stations/{id}

Request

  • Base URL: https://api.roote.ai
  • URL: https://api.roote.ai/v1/transit/stations/{id}
  • Auth: one of:
    • none
    • HTTP bearer

Path parameters

idstring required

Query parameters

projectionboolean

Legacy additive presentation, only with public_contract=legacy.

public_contract'transport-1.0.0' | 'legacy' | 'roote-1.1.0'

Omit for strict DTO. Version remains an explicit alias. legacy is deprecated; no silent fallback.

consolidatedboolean

Opt-in station-stop-point-v1: canonical Station, qualified StopPoints, scoped provider refs and stored Pattern directions. Returns requested_id separately; canonical IDs are never rewritten in this projection.

Response

Strict public DTO (default and explicit version alias).

OR
OR
OR
OR

Changes

No recorded changes to this operation across all 1 revision of this API.