{"openapi":"3.1.0","info":{"title":"Bike-Share API","version":"1.0.0","description":"Every public bike-share and e-scooter system in the world as an API — 1,500+ systems across 48 countries from the MobilityData GBFS catalog, plus LIVE station availability. Browse and search the systems catalog by country or name (Citi Bike, Vélib', Divvy, Blue Bikes, Capital Bikeshare, …), look up a system with its GBFS feed URLs, and fetch real-time station data — each station's name, location, capacity and how many bikes and docks are free right now — or find the nearest stations to any coordinate by great-circle distance. Ideal for trip-planning, mobility, maps and smart-city apps. Catalog data from MobilityData; live availability from each operator's official GBFS feed.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bikeshare-api","description":"oanor gateway"}],"tags":[{"name":"Bike-Share"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/nearby":{"get":{"operationId":"get_v1_nearby","tags":["Bike-Share"],"summary":"LIVE nearest stations to a coordinate","description":"","parameters":[{"name":"system","in":"query","required":true,"description":"System id (live GBFS feed)","schema":{"type":"string"}},{"name":"lat","in":"query","required":false,"description":"Latitude (-90..90)","schema":{"type":"string"}},{"name":"lon","in":"query","required":false,"description":"Longitude (-180..180)","schema":{"type":"string"}},{"name":"radius_km","in":"query","required":false,"description":"Search radius in km (0.1-100, default 2)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 20)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/stations":{"get":{"operationId":"get_v1_stations","tags":["Bike-Share"],"summary":"LIVE station availability for a system","description":"","parameters":[{"name":"system","in":"query","required":true,"description":"System id (live GBFS feed)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max stations (1-1000, default 100)","schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/system":{"get":{"operationId":"get_v1_system","tags":["Bike-Share"],"summary":"One system + GBFS feed URLs","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"System id, e.g. bluebikes","schema":{"type":"string"},"example":"bluebikes"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"system":{"url":"https://www.bluebikes.com/","name":"Blue Bikes","location":"Boston, MA","system_id":"bluebikes","country_code":"US","auth_required":false,"auto_discovery_url":"https://gbfs.bluebikes.com/gbfs/gbfs.json","supported_versions":"1.1"}},"meta":{"timestamp":"2026-05-31T08:16:15.979Z","request_id":"41d625ce-9232-4aa5-a4b4-67daf2e242d3"},"status":"ok","message":"System retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/systems":{"get":{"operationId":"get_v1_systems","tags":["Bike-Share"],"summary":"Catalog of bike-share systems","description":"","parameters":[{"name":"country","in":"query","required":false,"description":"ISO country code, e.g. US, FR, DE","schema":{"type":"string"},"example":"US"},{"name":"q","in":"query","required":false,"description":"Search by system name / location","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-200, default 50)","schema":{"type":"string"},"example":"50"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"limit":50,"total":175,"offset":0,"filters":{"country":"US"},"systems":[{"url":"https://aventura.bcycle.com","name":"Aventura BCycle","location":"Aventura, FL","system_id":"bcycle_aventura","country_code":"US","auth_required":false},{"url":"https://www.baywheels.com/","name":"Bay Wheels","location":"San Francisco, CA","system_id":"lyft_bay","country_code":"US","auth_required":false},{"url":"https://bentonville.bcycle.com","name":"Bentonville BCycle","location":"Bentonville, AR","system_id":"bcycle_bentonville","country_code":"US","auth_required":false},{"url":"https://www.bikechattanooga.com/","name":"Bike Chattanooga","location":"Chattanooga, TN","system_id":"bike_chattanooga","country_code":"US","auth_required":false},{"url":"https://bikelnk.bcycle.com","name":"BikeLNK","location":"Lincoln, NE","system_id":"bcycle_bikelnk","country_code":"US","auth_required":false},{"url":"https://www.biketownpdx.com/","name":"BIKETOWN","location":"Portland, OR","system_id":"biketown_pdx","country_code":"US","auth_required":false},{"url":"https://gobiki.org/","name":"Biki","location":"Honolulu, HI","system_id":"go_biki","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Alexandria","location":"Alexandria, VA","system_id":"bird-alexandria","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Arlingtonco","location":"Arlington, VA","system_id":"bird-arlingtonco","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Atlanta","location":"Atlanta, GA","system_id":"bird-atlanta","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Cleveland","location":"Cleveland, OH","system_id":"bird-cleveland","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Columbus","location":"Columbus, OH","system_id":"bird-columbus","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Culver City","location":"Culver City, CA","system_id":"bird-culver-city","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Dallas","location":"Dallas, TX","system_id":"bird-dallas","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Denver","location":"Denver, CO","system_id":"bird-denver","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Detroit","location":"Detroit, MI","system_id":"bird-detroit","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Durham","location":"Durham, NC","system_id":"bird-durham","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Fairfax","location":"Fairfax, VA","system_id":"bird-fairfax","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Gainesville","location":"Gainesville, FL","system_id":"bird-gainesville","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Greensboro","location":"Greensboro, NC","system_id":"bird-greensboro","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Indianapolis","location":"Indianapolis, IN","system_id":"bird-indianapolis","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Kansas City","location":"Kansas City, MO","system_id":"bird-kansas-city","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Lexington","location":"Lexington, KY","system_id":"bird-lexington","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Los Angeles","location":"Los Angeles, CA","system_id":"bird-los-angeles","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Louisville","location":"Louisville, KY","system_id":"bird-louisville","country_code":"US","auth_required":false},{"url":"https://bird.co","name":"Bird Miami","location":"Miami, FL","system_id":"bird-miami","country_code":"US","auth_required":false},{"url":"https://bird.co","name":"Bird Montgomery County","location":"Montgomery County, MD","system_id":"provider-null-montgomery-county","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Nashville","location":"Nashville, TN","system_id":"bird-nashville","country_code":"US","auth_required":false},{"url":"https://bird.co","name":"Bird New York","location":"New York, NY","system_id":"bird-new-york","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Newark","location":"Newark, NJ","system_id":"bird-newark","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Orlando","location":"Orlando, FL","system_id":"bird-orlando","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Portland","location":"Portland, OR","system_id":"bird-portland","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Reno","location":"Reno, NV","system_id":"bird-reno","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Richmond","location":"Richmond","system_id":"bird-richmond","country_code":"US","auth_required":false},{"url":"https://www.bird.co/","name":"Bird Seattle Washington","location":"Seattle, WA","system_id":"bird-seattle-washington","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird St Louis","location":"St Louis, MO","system_id":"bird-st-louis","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Tempe","location":"Tempe, AZ","system_id":"bird-tempe","country_code":"US","auth_required":false},{"url":"https://www.bird.co","name":"Bird Washington DC","location":"Washington, DC","system_id":"bird-washington-dc","country_code":"US","auth_required":false},{"url":"https://www.bluebikes.com/","name":"Blue Bikes","location":"Boston, MA","system_id":"bluebikes","country_code":"US","auth_required":false},{"url":"https://www.bolt.eu/","name":"Bolt Technology OÜ","location":"Washington, DC","system_id":"BoltEU_Washington DC","country_code":"US","auth_required":false},{"url":"https://boulder.bcycle.com","name":"Boulder BCycle","location":"Boulder, CO","system_id":"bcycle_boulder","country_code":"US","auth_required":false},{"url":"https://broward.bcycle.com","name":"Broward B-cycle","location":"Fort Lauderdale, FL","system_id":"bcycle_broward","country_code":"US","auth_required":false},{"url":"https://bublrbikes.com","name":"Bublr Bikes","location":"Milwaukee, WI","system_id":"bcycle_bublr","country_code":"US","auth_required":false},{"url":"http://www.capitalbikeshare.com","name":"Capital Bike Share","location":"Washington, DC","system_id":"cabi","country_code":"US","auth_required":false},{"url":"https://www.capmetro.org/bikeshare","name":"CapMetro","location":"Austin, TX","system_id":"austin","country_code":"US","auth_required":false},{"url":"https://www.cincyredbike.org","name":"Cincy Red Bike","location":"Cincinnati, OH","system_id":"bcycle_cincyredbike","country_code":"US","auth_required":false},{"url":"https://www.citibikenyc.com","name":"Citi Bike","location":"New York, NY","system_id":"lyft_nyc","country_code":"US","auth_required":false},{"url":"https://clemson.bcycle.com","name":"Clemson BikeShare","location":"Clemson, SC","system_id":"bcycle_clemson","country_code":"US","auth_required":false},{"url":"http://www.cogobikeshare.com/","name":"CoGo","location":"Columbus, OH","system_id":"cogo","country_code":"US","auth_required":false},{"url":"https://desmoines.bcycle.com","name":"Des Moines B-cycle","location":"Des Moines, IA","system_id":"bcycle_desmoines","country_code":"US","auth_required":false}]},"meta":{"timestamp":"2026-05-31T08:16:16.051Z","request_id":"b9937c21-354b-451f-bce4-bcacbc75a344"},"status":"ok","message":"Systems listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals & top countries","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Worldwide bike-share & e-scooter systems (GBFS). /v1/systems and /v1/system are the bundled catalog; /v1/stations and /v1/nearby fetch LIVE availability (bikes & docks free) from each system's GBFS feeds. Systems requiring authentication are not supported for live data.","source":"MobilityData GBFS catalog + live GBFS feeds","countries":48,"top_countries":[{"count":259,"country_code":"FR"},{"count":250,"country_code":"DE"},{"count":175,"country_code":"US"},{"count":94,"country_code":"PL"},{"count":85,"country_code":"NO"},{"count":69,"country_code":"ES"},{"count":55,"country_code":"FI"},{"count":55,"country_code":"GB"},{"count":53,"country_code":"NL"},{"count":49,"country_code":"CH"},{"count":45,"country_code":"CZ"},{"count":37,"country_code":"BE"}],"total_systems":1504},"meta":{"timestamp":"2026-05-31T08:16:16.128Z","request_id":"3b226f17-b957-4f74-b6ad-e313082b454f"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3400,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":540,"monthly_call_quota":48500,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1420,"monthly_call_quota":242000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3650,"monthly_call_quota":1210000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bikeshare-api"}