Developer docs

API Docs

OpenAPI and LLM-readable documentation for the ATL Transit Live resource API, SSE representations, webhooks, and historical export feeds.

OpenAPI YAML

Swagger-compatible schema for API clients and generated SDKs.

Swagger UI

Rendered operation docs from the OpenAPI schema.

llms.txt

Short machine-readable project and API guide.

llms-full.txt

Expanded LLM context with endpoints, event envelopes, and billing units.

Quick start

API clients authenticate with bearer keys. Responses include `X-API-Version`, `X-Meter-Unit`, and `X-RateLimit-Policy`.

Free

20 req/5min, 0 SSE, max `limit=20`

Regular

600 req/5min, 2 SSE, max `limit=100`

Max

6000 req/5min, 25 SSE, max `limit=1000`

curl -H "Authorization: Bearer $MARTA_FAIL_API_KEY" \
  "https://atltransit.live/api/v1/rail/realtime?line=RED&limit=25"

Endpoint inventory

The Swagger schema is the source of truth; this table summarizes the implemented surface and billing unit.

Endpoint inventory
Method	Path	Group	Meter	Value add
GET	/api/v1/rail	Rail	API request	Rail line metadata and links to realtime rail resources.
GET	/api/v1/rail/realtime	Rail	API request	Normalized arrivals plus train, line, and station delay summaries. JSON by default, SSE with content negotiation.
GET	/api/v1/rail/alerts	Rail	API request	Stored rail alerts from PostgreSQL with status, line, station, source, cursor, JSON, and SSE options.
GET	/api/v1/bus	Bus	API request	Bus route directory and reliability snapshots.
GET	/api/v1/bus/realtime	Bus	API request	GTFS-RT bus vehicle positions, route summaries, cursor pagination, JSON, and SSE options.
GET	/api/v1/bus/alerts	Bus	API request	Stored bus alerts from PostgreSQL with status, route, station, source, cursor, JSON, and SSE options.
GET	/api/v1/bus/{route_id}/reliability	Bus	API request	Bus route reliability rollups by day, week, or period. JSON by default, SSE with content negotiation.
GET	/api/v1/rail/{line}/reliability	Rail	API request	Rail line reliability rollups when retained rows are available. JSON by default, SSE with content negotiation.
GET	/api/v1/streetcar	Streetcar	API request	Streetcar route metadata and related alert links.
GET	/api/v1/streetcar/realtime	Streetcar	API request	GTFS-RT streetcar vehicle positions and route freshness summaries. JSON by default, SSE with content negotiation.
GET	/api/v1/streetcar/alerts	Streetcar	API request	Stored streetcar alerts from PostgreSQL with status, route, station, source, cursor, JSON, and SSE options.
GET	/api/v1/streetcar/{route_id}/reliability	Streetcar	API request	Streetcar reliability rollups when retained rows are available. JSON by default, SSE with content negotiation.
GET	/api/v1/history/exports	History	API request	Historical export manifests for retained datasets. Max plan only.
POST	/api/v1/webhooks/endpoints	Webhooks	API request	Register signed webhook delivery endpoints.
GET	/api/v1/webhooks/deliveries	Webhooks	API request	Webhook delivery audit and retry state.
GET	/api/v1/bus/{route_id}/realtime	Bus	API request	GTFS-RT vehicle positions for a single bus route. JSON by default, SSE with content negotiation.
GET	/api/v1/streetcar/{route_id}/realtime	Streetcar	API request	GTFS-RT vehicle positions for a single streetcar route. JSON by default, SSE with content negotiation.
GET	/api/v1/alerts	Alerts	API request	Stored cross-mode service alerts from PostgreSQL with status, route/line, station, source, and cursor options.
GET	/api/v1/events/stream	Events	SSE connection minute	Persistent server-sent event stream of alert, realtime, and reliability events. Metered by connection-minute.

SSE

Alerts, realtime positions, and reliability rollups return JSON by default, or `text/event-stream` with `Accept: text/event-stream` or `?format=sse`.

Webhooks

Webhook endpoints filter by mode, route/line, and event type — covering the same alert, realtime, reliability, and export events.