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`.
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.
| 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.