City Bikes API v2

How to Use This API

1. List All Networks

Returns every bike share network indexed by City Bikes:

http://api.citybik.es/v2/networks

Each network includes its id, name, city, country, GPS coordinates, and the company that operates it.

2. Get Network Details (Stations)

Get all stations for a specific network. Replace {network_id} with the network's ID from step 1:

http://api.citybik.es/v2/networks/velib

Returns station-level data: station name, latitude/longitude, free bikes, empty slots, and timestamp of last update.

3. Filter by Proximity (Using Network Location)

You can filter networks near GPS coordinates client-side after fetching all networks, or use the network's location field to calculate distances. There is no server-side geo-filtering endpoint, but the lightweight response makes client-side filtering fast.

http://api.citybik.es/v2/networks

4. Response Format

{
  "network": {
    "id": "velib",
    "name": "V\u00e9lib' M\u00e9tropole",
    "location": {
      "city": "Paris",
      "country": "FR",
      "latitude": 48.8566,
      "longitude": 2.3522
    },
    "stations": [
      {
        "id": "station-1",
        "name": "Station Name",
        "free_bikes": 5,
        "empty_slots": 10,
        "latitude": 48.857,
        "longitude": 2.353,
        "timestamp": "2026-06-16T10:00:00Z"
      }
    ]
  }
}

5. JavaScript — Find Nearby Bikes

fetch('http://api.citybik.es/v2/networks/velib')
  .then(r => r.json())
  .then(data => {
    const stations = data.network.stations;
    const available = stations.filter(s => s.free_bikes > 0);
    console.log(`V\u00e9lib' has ${available.length} stations with bikes`);
    available.forEach(s => {
      console.log(`${s.name}: ${s.free_bikes} bikes available`);
    });
  })
  .catch(err => console.error('City Bikes error:', err));

6. Python — Station Status Check

import requests

network_id = 'bixi-montreal'
resp = requests.get(f'http://api.citybik.es/v2/networks/{network_id}')
data = resp.json()

total_bikes = sum(s['free_bikes'] for s in data['network']['stations'])
total_docks = sum(s['empty_slots'] for s in data['network']['stations'])
print(f"Bixi Montreal: {total_bikes} bikes, {total_docks} empty docks")
print(f"Total stations: {len(data['network']['stations'])}")

7. Python — Find Networks by Country

import requests

resp = requests.get('http://api.citybik.es/v2/networks')
networks = resp.json()['networks']

# Find all networks in Germany
de_networks = [n for n in networks if n['location']['country'] == 'DE']
print(f"Germany has {len(de_networks)} bike networks:")
for n in de_networks:
    print(f"  \u2022 {n['name']} ({n['location']['city']})")