Welcome to the documentation for the UChicago Shuttles API.
\nAll data are reported in UTC.
\nBase URL: https://uchicagoshuttles.com
\nAuthentication: Pass your API Key in the header of your request on the \"key\" parameter. Don't have an API Key? Get one at uchicagoshuttles.com
\nHTTP Error 406: In case of code 406, make sure you are passing a \"User-Agent\" header in your request.
\nStuck? Take a look at an example iPython Notebook.
\nBugs? Comments? Reach out! shuttles@andreithuler.com
\nReturns the number of shuttles running between two dates reported at 1 minute intervals as well as a breakdown by route.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d1a1344-99a5-476a-b266-14e7bd8022cf","id":"7d1a1344-99a5-476a-b266-14e7bd8022cf","name":"UChicago Shuttles API","type":"collection"}},"urlObject":{"path":["api","getNumShuttles"],"host":[""],"query":[{"description":{"content":"Beginning of date range to consider in the results
\n","type":"text/plain"},"key":"start","value":"2024-10-01 10:00:00"},{"description":{"content":"End of date range to consider in the results
\n","type":"text/plain"},"key":"end","value":"2024-10-01 10:10:00"}],"variable":[]}},"response":[{"id":"f399acd2-ee0d-4b31-a893-ab7c90501575","name":"Get Number of Shuttles","originalRequest":{"method":"GET","header":[],"url":{"raw":"/api/getNumShuttles?start=2024-10-01 10:00:00&end=2024-10-01 10:10:00","host":[""],"path":["api","getNumShuttles"],"query":[{"key":"start","value":"2024-10-01 10:00:00","description":"Beginning of date range to consider in the results"},{"key":"end","value":"2024-10-01 10:10:00","description":"End of date range to consider in the results"}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Date","value":"Fri, 10 Jan 2025 19:30:45 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) PHP/8.3.14 mod_fcgid/2.3.10-dev"},{"key":"Content-Location","value":"getNumShuttles.php"},{"key":"Vary","value":"negotiate"},{"key":"TCN","value":"choice"},{"key":"X-Powered-By","value":"PHP/8.3.14"},{"key":"Content-Disposition","value":"attachment; filename=query.csv"},{"key":"Content-Length","value":"6484"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"text/csv;charset=UTF-8"}],"cookie":[],"responseTime":null,"body":"timestamp,NumShuttlesRunning,RouteBreakdown,NumAggPassengers,NumShuttlesOOS,NumShuttlesNoGPS\r\n2024-10-01 10:00:22,6,[\"North\": 2; \"Drexel\": 1; \"Central\": 1; \"Apostolic\": 1; \"Medical Shuttle\": 1; \"63rd (CTA) (CTA)\": 87; \"Friend Center/Metra\": 1; \"Garfield (CTA) (CTA)\": 69; \"59th/61st (CTA) (CTA)\": 37; \"Stony Island (CTA) (CTA)\": 43; \"Central/Ridge (CTA) (CTA)\": 43; \"Cottage Grove (CTA) (CTA)\": 134; \"Downtown Campus Connector\": 2; \"Jeffery Local (CTA) (CTA)\": 52; \"Hyde Park Express (CTA) (CTA)\": 25; \"Jackson Park Express (CTA) (CTA)\": 57; \"Cottage Grove Express (CTA) (CTA)\": 39; \"U. of Chicago/Kenwood (CTA) (CTA)\": 14; \"U. of Chicago/Hyde Park (CTA) (CTA)\": 8; \"University of Chicago Hospitals Express (CTA) (CTA)\": 9],0,2,620\r\n2024-10-01 10:01:22,6,[\"North\": 2; \"Drexel\": 1; \"Central\": 1; \"Apostolic\": 1; \"Medical Shuttle\": 1; \"63rd (CTA) (CTA)\": 87; \"Friend Center/Metra\": 1; \"Garfield (CTA) (CTA)\": 69; \"59th/61st (CTA) (CTA)\": 37; \"Stony Island (CTA) (CTA)\": 43; \"Central/Ridge (CTA) (CTA)\": 43; \"Cottage Grove (CTA) (CTA)\": 134; \"Downtown Campus Connector\": 2; \"Jeffery Local (CTA) (CTA)\": 52; \"Hyde Park Express (CTA) (CTA)\": 25; \"Jackson Park Express (CTA) (CTA)\": 57; \"Cottage Grove Express (CTA) (CTA)\": 39; \"U. of Chicago/Kenwood (CTA) (CTA)\": 14; \"U. of Chicago/Hyde Park (CTA) (CTA)\": 8; \"University of Chicago Hospitals Express (CTA) (CTA)\": 9],0,2,620\r\n2024-10-01 10:02:22,6,[\"North\": 2; \"Drexel\": 1; \"Central\": 1; \"Apostolic\": 1; \"Medical Shuttle\": 1; \"63rd (CTA) (CTA)\": 87; \"Friend Center/Metra\": 1; \"Garfield (CTA) (CTA)\": 69; \"59th/61st (CTA) (CTA)\": 37; \"Stony Island (CTA) (CTA)\": 43; \"Central/Ridge (CTA) (CTA)\": 43; \"Cottage Grove (CTA) (CTA)\": 134; \"Downtown Campus Connector\": 2; \"Jeffery Local (CTA) (CTA)\": 52; \"Hyde Park Express (CTA) (CTA)\": 25; \"Jackson Park Express (CTA) (CTA)\": 57; \"Cottage Grove Express (CTA) (CTA)\": 39; \"U. of Chicago/Kenwood (CTA) (CTA)\": 14; \"U. of Chicago/Hyde Park (CTA) (CTA)\": 8; \"University of Chicago Hospitals Express (CTA) (CTA)\": 9],0,3,620\r\n2024-10-01 10:03:23,6,[\"North\": 1; \"Drexel\": 1; \"Central\": 1; \"Apostolic\": 2; \"Medical Shuttle\": 1; \"63rd (CTA) (CTA)\": 87; \"Friend Center/Metra\": 1; \"Garfield (CTA) (CTA)\": 69; \"59th/61st (CTA) (CTA)\": 37; \"Stony Island (CTA) (CTA)\": 43; \"Central/Ridge (CTA) (CTA)\": 43; \"Cottage Grove (CTA) (CTA)\": 134; \"Downtown Campus Connector\": 2; \"Jeffery Local (CTA) (CTA)\": 52; \"Hyde Park Express (CTA) (CTA)\": 25; \"Jackson Park Express (CTA) (CTA)\": 57; \"Cottage Grove Express (CTA) (CTA)\": 39; \"U. of Chicago/Kenwood (CTA) (CTA)\": 14; \"U. of Chicago/Hyde Park (CTA) (CTA)\": 8; \"University of Chicago Hospitals Express (CTA) (CTA)\": 9],0,3,620\r\n2024-10-01 10:04:23,6,[\"North\": 1; \"Drexel\": 1; \"Central\": 1; \"Apostolic\": 2; \"Medical Shuttle\": 1; \"63rd (CTA) (CTA)\": 87; \"Friend Center/Metra\": 1; \"Garfield (CTA) (CTA)\": 69; \"59th/61st (CTA) (CTA)\": 37; \"Stony Island (CTA) (CTA)\": 43; \"Central/Ridge (CTA) (CTA)\": 43; \"Cottage Grove (CTA) (CTA)\": 134; \"Downtown Campus Connector\": 2; \"Jeffery Local (CTA) (CTA)\": 52; \"Hyde Park Express (CTA) (CTA)\": 25; \"Jackson Park Express (CTA) (CTA)\": 57; \"Cottage Grove Express (CTA) (CTA)\": 39; \"U. of Chicago/Kenwood (CTA) (CTA)\": 14; \"U. of Chicago/Hyde Park (CTA) (CTA)\": 8; \"University of Chicago Hospitals Express (CTA) (CTA)\": 9],0,3,620\r\n2024-10-01 10:05:24,7,[\"North\": 1; \"Drexel\": 1; \"Central\": 1; \"Apostolic\": 3; \"Medical Shuttle\": 1; \"63rd (CTA) (CTA)\": 87; \"Friend Center/Metra\": 1; \"Garfield (CTA) (CTA)\": 69; \"59th/61st (CTA) (CTA)\": 37; \"Stony Island (CTA) (CTA)\": 43; \"Central/Ridge (CTA) (CTA)\": 43; \"Cottage Grove (CTA) (CTA)\": 134; \"Downtown Campus Connector\": 2; \"Jeffery Local (CTA) (CTA)\": 52; \"Hyde Park Express (CTA) (CTA)\": 25; \"Jackson Park Express (CTA) (CTA)\": 57; \"Cottage Grove Express (CTA) (CTA)\": 39; \"U. of Chicago/Kenwood (CTA) (CTA)\": 14; \"U. of Chicago/Hyde Park (CTA) (CTA)\": 8; \"University of Chicago Hospitals Express (CTA) (CTA)\": 9],3,2,620\r\n2024-10-01 10:06:24,7,[\"North\": 1; \"Drexel\": 1; \"Central\": 1; \"Apostolic\": 3; \"Medical Shuttle\": 1; \"63rd (CTA) (CTA)\": 87; \"Friend Center/Metra\": 1; \"Garfield (CTA) (CTA)\": 69; \"59th/61st (CTA) (CTA)\": 37; \"Stony Island (CTA) (CTA)\": 43; \"Central/Ridge (CTA) (CTA)\": 43; \"Cottage Grove (CTA) (CTA)\": 135; \"Downtown Campus Connector\": 2; \"Jeffery Local (CTA) (CTA)\": 52; \"Hyde Park Express (CTA) (CTA)\": 25; \"Jackson Park Express (CTA) (CTA)\": 57; \"Cottage Grove Express (CTA) (CTA)\": 38; \"U. of Chicago/Kenwood (CTA) (CTA)\": 14; \"U. of Chicago/Hyde Park (CTA) (CTA)\": 8; \"University of Chicago Hospitals Express (CTA) (CTA)\": 9],2,2,620\r\n2024-10-01 10:07:25,7,[\"North\": 1; \"Drexel\": 1; \"Central\": 1; \"Apostolic\": 3; \"Medical Shuttle\": 1; \"63rd (CTA) (CTA)\": 86; \"Friend Center/Metra\": 1; \"Garfield (CTA) (CTA)\": 69; \"59th/61st (CTA) (CTA)\": 38; \"Stony Island (CTA) (CTA)\": 43; \"Central/Ridge (CTA) (CTA)\": 43; \"Cottage Grove (CTA) (CTA)\": 135; \"Downtown Campus Connector\": 2; \"Jeffery Local (CTA) (CTA)\": 52; \"Hyde Park Express (CTA) (CTA)\": 25; \"Jackson Park Express (CTA) (CTA)\": 57; \"Cottage Grove Express (CTA) (CTA)\": 38; \"U. of Chicago/Kenwood (CTA) (CTA)\": 14; \"U. of Chicago/Hyde Park (CTA) (CTA)\": 8; \"University of Chicago Hospitals Express (CTA) (CTA)\": 9],2,2,620\r\n2024-10-01 10:08:25,7,[\"North\": 1; \"Drexel\": 1; \"Central\": 1; \"Apostolic\": 3; \"Medical Shuttle\": 1; \"63rd (CTA) (CTA)\": 86; \"Friend Center/Metra\": 1; \"Garfield (CTA) (CTA)\": 69; \"59th/61st (CTA) (CTA)\": 38; \"Stony Island (CTA) (CTA)\": 43; \"Central/Ridge (CTA) (CTA)\": 43; \"Cottage Grove (CTA) (CTA)\": 135; \"Downtown Campus Connector\": 2; \"Jeffery Local (CTA) (CTA)\": 52; \"Hyde Park Express (CTA) (CTA)\": 25; \"Jackson Park Express (CTA) (CTA)\": 57; \"Cottage Grove Express (CTA) (CTA)\": 38; \"U. of Chicago/Kenwood (CTA) (CTA)\": 14; \"U. of Chicago/Hyde Park (CTA) (CTA)\": 8; \"University of Chicago Hospitals Express (CTA) (CTA)\": 9],2,2,620\r\n2024-10-01 10:09:26,7,[\"North\": 1; \"Drexel\": 1; \"Central\": 1; \"Apostolic\": 3; \"Medical Shuttle\": 1; \"63rd (CTA) (CTA)\": 86; \"Friend Center/Metra\": 1; \"Garfield (CTA) (CTA)\": 69; \"59th/61st (CTA) (CTA)\": 38; \"Stony Island (CTA) (CTA)\": 43; \"Central/Ridge (CTA) (CTA)\": 43; \"Cottage Grove (CTA) (CTA)\": 135; \"Downtown Campus Connector\": 2; \"Jeffery Local (CTA) (CTA)\": 52; \"Hyde Park Express (CTA) (CTA)\": 25; \"Jackson Park Express (CTA) (CTA)\": 57; \"Cottage Grove Express (CTA) (CTA)\": 38; \"U. of Chicago/Kenwood (CTA) (CTA)\": 14; \"U. of Chicago/Hyde Park (CTA) (CTA)\": 8; \"University of Chicago Hospitals Express (CTA) (CTA)\": 9],2,2,620\r\n"}],"_postman_id":"5feaeec0-3741-48bb-b79d-980cf7cecbd4"},{"name":"Get Stops Data","id":"b7572ba7-8b14-4b5c-8093-ab1266f7789b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"/api/getStops?start=2024-10-01 10:00:00&end=2024-10-01 10:10:00","description":"Returns every stop event (every time a shuttle stops at or passes a stop) between two dates.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d1a1344-99a5-476a-b266-14e7bd8022cf","id":"7d1a1344-99a5-476a-b266-14e7bd8022cf","name":"UChicago Shuttles API","type":"collection"}},"urlObject":{"path":["api","getStops"],"host":[""],"query":[{"description":{"content":"Beginning of date range to consider in the results
\n","type":"text/plain"},"key":"start","value":"2024-10-01 10:00:00"},{"description":{"content":"End of date range to consider in the results
\n","type":"text/plain"},"key":"end","value":"2024-10-01 10:10:00"}],"variable":[]}},"response":[{"id":"478f3f39-0b66-4519-a972-e727b4d2bea3","name":"Get Stops Data","originalRequest":{"method":"GET","header":[],"url":{"raw":"/api/getStops?start=2024-10-01 10:00:00&end=2024-10-01 10:10:00","host":[""],"path":["api","getStops"],"query":[{"key":"start","value":"2024-10-01 10:00:00"},{"key":"end","value":"2024-10-01 10:10:00"}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Date","value":"Fri, 10 Jan 2025 21:19:24 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) PHP/8.3.14 mod_fcgid/2.3.10-dev"},{"key":"Content-Location","value":"getStops.php"},{"key":"Vary","value":"negotiate"},{"key":"TCN","value":"choice"},{"key":"X-Powered-By","value":"PHP/8.3.14"},{"key":"Content-Disposition","value":"attachment; filename=query.csv"},{"key":"Content-Length","value":"1791"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"text/csv;charset=UTF-8"}],"cookie":[],"responseTime":null,"body":"id,routeName,stopName,passengerLoad,stopDurationSeconds,arrivalTime,departureTime,stopId,busId,nextStopId\r\n363266,Friend Center/Metra,Goldblatt Pavilion,0,740,2024-10-01 09:47:53,2024-10-01 10:00:13,8612,4317,8613\r\n363267,Friend Center/Metra,Wyler Pavilion,0,18,2024-10-01 10:00:45,2024-10-01 10:01:03,8613,4317,8615\r\n363268,Drexel,Drexel Garage,0,69,2024-10-01 09:59:57,2024-10-01 10:01:07,8611,4538,8612\r\n363269,Friend Center/Metra,Bernard Mitchell Hospital,0,17,2024-10-01 10:01:03,2024-10-01 10:01:21,8615,4317,8616\r\n363270,Friend Center/Metra,58th Street & Drexel,0,20,2024-10-01 10:01:21,2024-10-01 10:01:42,8616,4317,8617\r\n363271,Friend Center/Metra,Comer Children's Hospital,0,12,2024-10-01 10:01:46,2024-10-01 10:01:58,8617,4317,138838\r\n363272,Friend Center/Metra,S Drexel Ave & 57th St,0,13,2024-10-01 10:01:58,2024-10-01 10:02:12,138838,4317,8635\r\n363273,Apostolic,Kenwood & 63rd,0,16,2024-10-01 10:03:12,2024-10-01 10:03:28,133007,4329,8612\r\n363274,Friend Center/Metra,Ellis Garage & Ratner Athletic Center (East),0,7,2024-10-01 10:03:25,2024-10-01 10:03:33,8635,4317,8618\r\n363275,Friend Center/Metra,Ronald McDonald House & Friend Center,0,11,2024-10-01 10:04:17,2024-10-01 10:04:29,8618,4317,140009\r\n363276,Drexel,Goldblatt Pavilion,3,26,2024-10-01 10:04:41,2024-10-01 10:05:08,8612,4538,8613\r\n363277,Drexel,Wyler Pavilion,2,39,2024-10-01 10:05:31,2024-10-01 10:06:10,8613,4538,8615\r\n363278,Apostolic,Goldblatt Pavilion,0,17,2024-10-01 10:07:49,2024-10-01 10:08:06,8612,4329,8613\r\n363279,Apostolic,Wyler Pavilion,0,13,2024-10-01 10:08:40,2024-10-01 10:08:54,8613,4329,8615\r\n363280,Apostolic,Bernard Mitchell Hospital,0,39,2024-10-01 10:08:54,2024-10-01 10:09:34,8615,4329,8616\r\n363281,Apostolic,58th Street & Drexel,0,18,2024-10-01 10:09:34,2024-10-01 10:09:53,8616,4329,8617\r\n"}],"_postman_id":"b7572ba7-8b14-4b5c-8093-ab1266f7789b"},{"name":"Get Ridership","id":"13f61de0-502c-42e6-9975-28dd46062c65","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"accept":true,"user-agent":true,"accept-encoding":true,"connection":true}},"request":{"method":"GET","header":[],"url":"/api/getRidership?start=2024-10-01 10:00:00&end=2024-10-01 13:10:00&aggregate=hour","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d1a1344-99a5-476a-b266-14e7bd8022cf","id":"7d1a1344-99a5-476a-b266-14e7bd8022cf","name":"UChicago Shuttles API","type":"collection"}},"urlObject":{"path":["api","getRidership"],"host":[""],"query":[{"description":{"content":"Beginning of date range to consider in the results
\n","type":"text/plain"},"key":"start","value":"2024-10-01 10:00:00"},{"description":{"content":"End of date range to consider in the results
\n","type":"text/plain"},"key":"end","value":"2024-10-01 13:10:00"},{"description":{"content":"How to deliver the results. Will accept any of \"minute\", \"hour\", \"day\", \"month\", \"year\". REMINDER: All times are in UTC.
\n","type":"text/plain"},"key":"aggregate","value":"hour"}],"variable":[]}},"response":[{"id":"172dbfbc-7282-4f7c-b061-73680b23e0ea","name":"Get Ridership","originalRequest":{"method":"GET","header":[],"url":{"raw":"/api/getRidership?start=2024-10-01 10:00:00&end=2024-10-01 13:10:00&aggregate=hour","host":[""],"path":["api","getRidership"],"query":[{"key":"start","value":"2024-10-01 10:00:00","description":"Beginning of date range to consider in the results"},{"key":"end","value":"2024-10-01 13:10:00","description":"End of date range to consider in the results"},{"key":"aggregate","value":"hour","description":"How to deliver the results. Will accept any of \"minute\", \"hour\", \"day\", \"month\", \"year\". REMINDER: All times are in UTC."}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Date","value":"Sat, 11 Jan 2025 19:03:54 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) PHP/8.3.14 mod_fcgid/2.3.10-dev"},{"key":"Content-Location","value":"getRidership.php"},{"key":"Vary","value":"negotiate"},{"key":"TCN","value":"choice"},{"key":"X-Powered-By","value":"PHP/8.3.14"},{"key":"Content-Disposition","value":"attachment; filename=query.csv"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Length","value":"106"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"text/csv;charset=UTF-8"}],"cookie":[],"responseTime":null,"body":"timeReported,ridership\r\n2024-10-01 10:0,18\r\n2024-10-01 11:0,100\r\n2024-10-01 12:0,178\r\n2024-10-01 13:0,49\r\n"}],"_postman_id":"13f61de0-502c-42e6-9975-28dd46062c65"}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"key"},{"key":"value","value":""}]}},"event":[{"listen":"prerequest","script":{"id":"55db51f5-c848-42ce-b81d-390a372f5e63","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"e04f4cc0-7d3c-43e8-8ed0-d3a6f05f401e","type":"text/javascript","packages":{},"exec":[""]}}],"variable":[{"key":"key","value":"","type":"string"},{"key":"base_url","value":"","type":"string","disabled":true},{"key":"base_url","value":"","type":"string","disabled":true},{"key":"base_url","value":"","type":"string"}]}