Bongo Data

All of the data for Bongo is copyrighted by the University of Iowa, the City of Iowa City and/or the City of Coralville and is not permitted to be used in a commercial application.

API Endpoints

Route List Listing of routes for all transit agencies

/routes

Parameters

None

Returns

Array of routes with the following data:

Name	Type	Description
`id`	Number	Unique identifier for the route
`name`	String	Human readable name for the route
`shortname`	String	Short name for route, used for URLs
`color`	String	Hex code for the color for the route
`agency`	String	Agency short name, used for URLs
`agencyname`	String	Human readable name for the agency

Route Info Information for a specific route

/routes/{routeid}

Parameter

Name	Type	Description
`routeid`	Number	Unique identifier for the route

Returns

Route object with the following data:

Name	Type	Description
`id`	Number	Unique identifier for the route
`name`	String	Human readable name for the route
`shortname`	String	Short name for route, used for URLs
`color`	String	Hex code for the color for the route
`agency`	String	Agency short name, used for URLs
`agencyname`	String	Human readable name for the agency
`stops`	Array	Collection of all stops for the route. Each stop has an `id`, `name`, `lat` and `lon` value
`maxlat`	Number	Maximum latitude for the route
`minlat`	Number	Minimum latitude for the route
`maxlon`	Number	Maximum longitude for the route
`minlat`	Number	Minimum longitude for the route
`paths`	Array	Collection of all paths for the route. Each path has a array of points which have a `lat` and `lon` value

Stop List Listing of stops for all transit agencies

/stops

Parameters

None

Returns

Array of stops with the following data:

Name	Type	Description
`id`	Number	Unique identifier for the stop
`name`	String	Human readable name for the stop
`lat`	Number	Latitude for the stop
`lon`	Number	Longitude for the stop

Stop numbers are organized in the following way:
1-999 - Shared stop across more than one agency
1000-3999 - Cambus stop
4000-6999 - Coralville stop
7000-9999 - Iowa City stop

Stop Info Information for a specific stop

/stops/{stopid}

Parameter

Name	Type	Description
`stopid`	Number	Unique identifier for the stop

Returns

Stop object with the following data:

Name	Type	Description
`id`	Number	Unique identifier for the stop
`name`	String	Human readable name for the stop
`lat`	Number	Latitude for the stop
`lon`	Number	Longitude for the stop
`messages`	Array	Collection of all messages for routes that service this stop. Each message has an `id`, `name`, `text`, `start` and `end` value

Stop numbers are organized in the following way:
1-999 - Shared stop across more than one agency
1000-3999 - Cambus stop
4000-6999 - Coralville stop
7000-9999 - Iowa City stop

Buses Listing of buses running for a route

/buses/{routeid}

Parameter

Name	Type	Description
`routeid`	Number	Unique identifier for the route

Returns

Array of buses with the following data:

Name	Type	Description
`id`	Number	Unique identifier for the bus
`lat`	Number	Latitude for the stop
`lon`	Number	Longitude for the stop
`heading`	Number	Bus heading in degrees

Predictions Listing of bus predictions for a stop

/predictions/{stopid}

Parameter

Name	Type	Description
`stopid`	Number	Unique identifier for the stop

Returns

Array of predictions with the following data:

Name	Type	Description
`routeid`	Number	Unique identifier for the route
`name`	String	Human readable name for the route
`shortname`	String	Short name for route, used for URLs
`busid`	Number	Unique identifier for the bus
`busnumber`	String	Bus label on the back of the bus
`seconds`	Number	Prediction in seconds until arrival
`minutes`	Number	Prediction in minutes until arrival, rounded up from seconds
`agency`	String	Agency short name, used for URLs
`agencyname`	String	Human readable name for the agency