Citybikes v2

The Citybikes v2 format is simple and ready to be used as is. It has been around since the project started and is our reference implementation for exposing the data extracted using pybikes.

Network list

This endpoint provides enough information to create a listing of available networks.

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

{
  "networks": [
    {
        "company": "JCDecaux", 
        "href": "/v2/networks/velib",  <-- network API endpoint
        "location": {
          "latitude": 48.856612, 
          "city": "Paris", 
          "longitude": 2.352233, 
          "country": "FRA"
        }, 
        "name": "Vélib'", 
        "id": "velib"
    },
    {...}
  ]
}

Network

Information about a network and its resources.

https://api.citybik.es/v2/networks/<network_id>

{
  "network": {
    "id": "divvy",
    "name": "Divvy",
    "location": {
      "latitude": 41.8781136,           Redundant network information
      "longitude": -87.6297982,
      "city": "Chicago, IL",            Just so you know where you are
      "country": "US"                   with less requests
    },
    "href": "/v2/networks/divvy",       This can be filtered by passing
    "company": [                        ?fields=stations to the URI
      "Motivate International, Inc.",
      "PBSC Urban Solutions"
    ],
    "ebikes": true,
    "gbfs_href": "https://gbfs.divvybikes.com/gbfs/gbfs.json",
    "stations": [
      {
        "id": "000db9b6e3849926d4868caf7096780d",
        "name": "Calumet Ave & 21st St",
        "latitude": 41.85418424947,
        "longitude": -87.6191537415,
        "timestamp": "2025-04-17T16:41:02505032+00:00Z",  <-- UTC Timestamp
        "free_bikes": 13,  <-- Available bikes
        "empty_slots": 1,  <-- Empty spaces
        "extra": {
          "uid": "a3ac8dfb-a135-11e9-9cda-0a87ae2ba916",
          "renting": 1,
          "returning": 1,
          "last_updated": 1744907952,
          "has_ebikes": true,           Extra information
          "ebikes": 1,
          "payment": [                  Information that is not constant
            "key",                      or always available between
            "creditcard",               different networks
            "transitcard"
          ],
          "payment-terminal": true,
          "slots": 15,
          "rental_uris": {
            "android": "https://chi.lft.to/lastmile_qr_scan",
            "ios": "https://chi.lft.to/lastmile_qr_scan"
          }
        }
      },
      {...}
    ],
    "vehicles": [     Roaming vehicle information when available
      {
        "id": "000d2b170283551da444b154dff3a485",
        "latitude": 41.960174084,
        "longitude": -87.754097939,
        "timestamp": "2025-04-17T16:41:02.822842+00:00Z",
        "extra": {
          "uid": "95a7c0eccf0eff27a6e9c603d93e0bdc",
          "online": true
        },
        "kind": "ebike"  <-- Vehicle type: bike, ebike, scooter
      },
      {...}
    ]
  }
}