Dockless Bikeshare Reporting Manual logo Dockless Bikeshare Reporting Manual

Scope

The City of Chicago requires that companies publish information about their system and bike availability using the General Bikeshare Feed Specification (GBFS) v1.1 (draft spec). This data will be used by the city to ensure equity of bike availability and can be used by the transit community to integrate dockless bikeshare data into mobile applications that are used by Chicagoans.

File Format

GBFS is a flexible format that consists of required and optional files. Below outlines the minimum requirements for operation within the City of Chicago.

Companies may also publish the optional files listed below. Likewise, companies may make additions to the GBFS format as long as it does not conflict with the minimum requirements.

Required Files

City of Chicago requires that companies publish six of the GBFS v1.1-draft files. Below are the required files that must be published:

File Name Defines
gbfs.json Auto-discovery file that links to all of the other files published by the system. This file is optional in the GBFS, but required by the City of Chicago.
system_information.json Describes the system including System operator, System location, year implemented, URLs, contact info, time zone.
station_information.json Mostly static list of all stations, their capacities and locations. (Note: This file may contain no information in a dockless system but is required by the City of Chicago in order to maintain compliance with the GBFS standard.)
free_bike_status.json Describes bikes that are available in non station-based systems. This file is optional in the GBFS, but required by the City of Chicago.
geofencing_zone_information.json Mostly static list of all geofencing zones, their capacities, locations and areas. This file is optional in the GBFS, but required by the City of Chicago.
geofencing_zone_status.json Defines geofencing zones available in the system and their link to physical stations if any. This file is optional in the GBFS, but required by the City of Chicago. Elements within the num_bikes_available_types array are required by the City of Chicago and should be set to 0 if not applicable.
system_regions.json Describes the regions the system is broken up into. This file is optional in the GBFS, but required by the City of Chicago.

Optional Files

These files are supported by GBFS, but are not mandatory:

File Name Defines
station_status.json Number of available bikes and docks at each station and station availability. Optional as system can be free floating.
system_hours.json Describes the hours of operation for the system.
system_calendar.json Describes the days of operation for the system.
system_pricing_plans.json Describes the system pricing.
system_alerts.json Describes current system alerts.

Reporting to Chicago

Companies will need to inform the City of Chicago of the location of the gbfs.json file on the internet. The gbfs.json file contains the necessary information to find other files related to the GBFS data.

If a token or authentication is required to view that file, the location to apply for the token must also be submitted to the City.