Requests

• Endpoints

• /api/v1/agencies/<agency>/routes - configuration for all routes, including stops and paths.
• /api/v1/agencies/<agency>/vehicles - all bus locations for a given agency.
• /api/v1/agencies/<agency>/predictions - all time predictions for a given agency.
• /api/v1/agencies/<agency>/messages - general messages as well as messages specific to each route.
• /api/v1/agencies/<agency>/multiPredictions - bus prediction times for specific stops.

• Examples

• https://gtbuses.herokuapp.com/api/v1/agencies/georgia-tech/routes
• https://gtbuses.herokuapp.com/api/v1/agencies/georgia-tech/vehicles
• https://gtbuses.herokuapp.com/api/v1/agencies/georgia-tech/predictions
• https://gtbuses.herokuapp.com/api/v1/agencies/georgia-tech/messages
• https://gtbuses.herokuapp.com/api/v1/agencies/georgia-tech/multiPredictions?stops=blue|cherfers

---

Responses

• Format

• All responses are returned in JSON format by default.
• Append .xml to any endpoint to receive a response in XML.
• For detailed info on the response format, click here.

• Status Codes

• 200 OK - request was successfully returned.
• 400 Bad Request - invalid request data.
• 404 Not Found - requested data not found.
• 502 Bad Gateway - request made to NextBus failed.

• Example

> GET /api/v1/agencies/georgia-tech/vehicles HTTP/1.1
> Host: gtbuses.herokuapp.com
> Cache-Control: no-cache
>
< HTTP/1.1 200 OK
< Connection: keep-alive
< Server: gunicorn/18.0
< Date: Fri, 07 Nov 2014 22:41:30 GMT
< Content-Type: application/json; charset=utf-8
< Content-Length: 350
< Via: 1.1 vegur
<

{"vehicle":[{"id":"392","lon":"-84.397375","routeTag":"red","predictable":"true","speedKmHr":"34","dirTag":"naveapts","heading":"255","lat":"33.772856","secsSinceReport":"11"}],"lastTime":{"time":"1527924430449"},"copyright":"All data copyright Georgia Tech Campus 2018.","keyForNextTime":{"value":"3097550136"}}

---